245954 - Make documentation links easier to find

Status: VERIFIED FIXED

(www.mozilla.org :: General, defect)

Description

[Brodie]

I find that every time I go to the 'developers' page at mozilla.org I have to
search for the documentation links. I think that they need to be split out into
their own section to make them easier to find.

I'll attach a diff of my suggested changes.

Comment 1

[Brodie]

Attachment: suggested change

Comment 2

[Brodie]

This isn't a radical move, it keeps the same feel of the website, it makes it
easier to see links. Do I need a review for this or should I just check the
changes in?

Comment 3

[Daniel Wang]

I don't think you need review for this

Comment 4

[Brodie]

I don't have CVS perms to write to the doc tree (using doctor). I can't find the
website using cvs command line. Anyone else want to help out???

Comment 5

[Anne (:annevk)]

I guess this will be resolved by bug 272268.

Comment 6

[Reed Loden [:reed]]

Since this page is still used and comment #3 says no review is needed, I'll check this in tomorrow.

Comment 7

[Reed Loden [:reed]]

dbaron: I noticed you mentioned you would like to be contacted with changes concerning this page. Would you like this change to be made?

Comment 8

[David Baron :dbaron: (⌚️UTC-5, no longer working on Mozilla)]

Changing "Web developers" to "people writing web pages about Mozilla languages and standards" is pretty clearly wrong.

Comment 9

[Reed Loden [:reed]]

(In reply to comment #8)
> Changing "Web developers" to "people writing web pages about Mozilla languages
> and standards" is pretty clearly wrong.
> 

Yeah, I noticed that too. Before I noticed your note at the bottom of the page, I was going to commit it and change that to be something like "Documentation for people writing web pages concerning Mozilla" or something like that.

Comment 10

[David Baron :dbaron: (⌚️UTC-5, no longer working on Mozilla)]

No, it has nothing to do with writing web pages *about* Mozilla.  It's about writing Web pages, or perhaps about writing Web pages that work correctly in Mozilla, but they don't have to be about Mozilla.

Comment 11

[Reed Loden [:reed]]

(In reply to comment #10)
> No, it has nothing to do with writing web pages *about* Mozilla.  It's about
> writing Web pages, or perhaps about writing Web pages that work correctly in
> Mozilla, but they don't have to be about Mozilla.
> 

Ah, so something like "Documentation for people writing web pages that are compliant with W3C and Mozilla standards"?

Comment 12

[David Baron :dbaron: (⌚️UTC-5, no longer working on Mozilla)]

Documentation for people writing Web pages using Web standards and Mozilla technologies.

Comment 13

[Reed Loden [:reed]]

(In reply to comment #12)
> Documentation for people writing Web pages using Web standards and Mozilla
> technologies.

Sounds great. Do you have a problem with anything else in the patch, or may I go ahead and commit with this change?

Comment 14

[David Baron :dbaron: (⌚️UTC-5, no longer working on Mozilla)]

With that change, and if you verify that the amazon.com URLs are unchanged (I didn't), go ahead.

Comment 15

[Reed Loden [:reed]]

Checking in mozilla-org/html/developer/index.html;
/cvsroot/mozilla-org/html/developer/index.html,v  <--  index.html
new revision: 1.48; previous revision: 1.47
done

I modified some of the other text to sound better and to match the other format, and I swapped the URLs back to the old ones as they were shorter (less likely not to work) and still worked just fine.

Comment 16

[Reed Loden [:reed]]

v. on production