471148 - Remove old Accessibility docs, and put online

Status: RESOLVED INVALID

(Core :: Disability Access APIs, defect)

Description

[Tyler Downer [He/Him]]

It seems like there is no reason to keep this very large file in the mozilla-central /accessible folder. It would be more appropriate on devmo, where it would be easier to get to (even if you don't have the source tree), and to maintain.

Comment 1

[Tyler Downer [He/Him]]

Attachment: Patch v1

This patch simply removes the doc, it still needs to be updated in content and the moved to dmo. Probably would be best to do that the same time this patch is checked in.

Comment 2

[Aaron Leventhal]

Feel free to remove it if you put it on devmo and link to it from this page:
https://developer.mozilla.org/En/Accessibility

The a11y team can update the docs to be correct for today's architecture.

Comment 3

[Tyler Downer [He/Him]]

I created https://developer.mozilla.org/En/Accessibility/Implementing_an_MSAA_Server. it still needs cleanup and a link, but it is the first rough draft.

Comment 4

[Aaron Leventhal]

Comment on attachment 354465 [details] [diff] [review]
Patch v1

Hmm. This seems to be a copy of http://www.mozilla.org/access/windows/msaa-server

But, it's not an exact copy. Sorry I didn't notice it before. The version being removed by this patch was last changed on April 30, 2003 and the mozilla.org version is more up-to-date. See the history here:
http://www.mozilla.org/access/windows/msaa-server

Comment 5

[Aaron Leventhal]

Here's the correct history link:
http://bonsai-www.mozilla.org/cvslog.cgi?file=mozilla-org/html/access/windows/msaa-server.html&rev=&root=/www/

Comment 6

[Tyler Downer [He/Him]]

OK, but the devmo does seem to be a better place to put it (being easier to edit, etc). But should we have two version?

Comment 7

[Aaron Leventhal]

devmo is better, and we only need 1 copy. 

It's just that no one has ever gotten around to migrating all the docs from mozilla.org/access to devmo.

Comment 8

[Tyler Downer [He/Him]]

Comment on attachment 354465 [details] [diff] [review]
Patch v1

I moved all the content from http://www.mozilla.org/access/windows/msaa-server to the devmo page.

Comment 9

[Aaron Leventhal]

Comment on attachment 354465 [details] [diff] [review]
Patch v1

Thanks, don't forget to do a redirect.

Comment 10

[Tyler Downer [He/Him]]

Redirect from where? The doc? That is not necessary, as I will link to this from https://developer.mozilla.org/En/Accessibility, which https://developer.mozilla.org/en/Mozilla_Source_Code_Directory_Structure links too, which is linked to by Bug 471548, which is waiting to land. I don't see a need for a redirect in the source code. I will create a redirect on http://www.mozilla.org/access/windows/msaa-server to the devmo page, if that is what you mean. Thanks for the +.

Comment 11

[Aaron Leventhal]

Yes, that's what I mean -- a redirect from http://www.mozilla.org/access/windows/msaa-server

Comment 12

[Tyler Downer [He/Him]]

OK, thanks for the clarification I will get that up tomorrow.

Comment 13

[Marco Zehe (:MarcoZ)]

Hi Tyler, let me know when you have, I will then checkin your patch. Thanks!

Comment 14

[Tyler Downer [He/Him]]

Attachment: Patch for mozilla.org

Quick and dirty way to get a redirect.

Comment 15

[Tyler Downer [He/Him]]

Don't have commit to the mozilla.org server. So this does the redirect for http://www.mozilla.org/access/windows/msaa-server.

Comment 16

[Aaron Leventhal]

Actually, there should be an .htaccess in that directory with other redirects which you can just add to ... no?

Comment 17

[Aaron Leventhal]

Comment on attachment 356016 [details] [diff] [review]
Patch for mozilla.org

I think you can also use a meta redirect, but whatever.

I couldn't cvs add the .htaccess, I kept getting:
cvs [add aborted]: end of file from server (consult above messages if any)
I'm not willing to spend more time figuring out why :/

Here's the .htaccess we'd use if we could get it added:
Options +MultiViews
Redirect permanent msaa-server http://developer.mozilla.org/en/docs/ARIA_User_Agent_Implementors_Guide
Redirect permanent msaa-server.html http://developer.mozilla.org/en/docs/ARIA_User_Agent_Implementors_Guide
Redirect permanent /access/windows/msaa-server.html http://developer.mozilla.org/en/docs/ARIA_User_Agent_Implementors_Guide
Redirect permanent /access/windows/msaa-server http://developer.mozilla.org/en/docs/ARIA_User_Agent_Implementors_Guide

Comment 18

[Aaron Leventhal]

Actually the .htaccess would have this:
Options +MultiViews
Redirect permanent msaa-server https://developer.mozilla.org/En/Accessibility/Implementing_an_MSAA_Server
Redirect permanent msaa-server.html https://developer.mozilla.org/En/Accessibility/Implementing_an_MSAA_Server
Redirect permanent /access/windows/msaa-server.html https://developer.mozilla.org/En/Accessibility/Implementing_an_MSAA_Server
Redirect permanent /access/windows/msaa-server https://developer.mozilla.org/En/Accessibility/Implementing_an_MSAA_Server

Comment 19

[Tyler Downer [He/Him]]

@Marco, could you check these in?

Comment 20

[Serge Gautherie (:sgautherie)]

I could check in the mozilla-central patch;
but I prefer if someone else check the mozilla.org patch first...

Comment 21

[Tyler Downer [He/Him]]

talking to marco about that still

Comment 22

[Serge Gautherie (:sgautherie)]

Who can actually land the mozilla.org part?

Comment 23

[Tyler Downer [He/Him]]

(In reply to comment #22)
Don't really know. kinda why this has sat for 7 1/2 months

Comment 24

[Marco Zehe (:MarcoZ)]

I am currently in the process of requesting commit access to mozilla.org. As soon as I have that, I'll land this baby!

Comment 25

[Tyler Downer [He/Him]]

@Marco, can you land this now? Thanks.

Comment 26

[Marco Zehe (:MarcoZ)]

Comment on attachment 356016 [details] [diff] [review]
Patch for mozilla.org

Taylor, I just tried to commit your patch, but this patch is malformed. It ends with:

>+<p>This page has moved to <a href="https://developer.mozilla.org/En/Accessibility/Implementing_an_MSAA_Server">https://developer.mozilla.org/En/Accessibility/Implementing_an_MSAA_Server</a>.
Please update your bo

which is invalid HTML and looks like it is also not where your patch file should end.

Please re-check that you have a completely working patch file and attach it to this bug so I can commit it. Thanks!

Comment 27

[Tyler Downer [He/Him]]

Sorry, yeah, that is nasty :). Let me get a new one up.

Comment 28

[Tyler Downer [He/Him]]

If anyone wants to finish this work, feel free to use the crappy patch I have above.

Comment 29

[James Teh [:Jamie]]

I don't think this page is useful any more, but it's archived here anyway. The source tree is actually the correct place for documentation like this these days since we have Firefox Source Docs.