Closed Bug 358668 Opened 18 years ago Closed 18 years ago

Rhino project webpages to meet m.o. guidelines (HTML 4.01 strict, markup, style, semantic, etc)

Categories

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

Product:
www.mozilla.org
Component:
General
Type:
defect
Priority:
Not set
Severity:
normal

Tracking

(Not tracked)

Status:
VERIFIED FIXED

People

(Reporter: bugzilla, Assigned: bugzilla)

References

(
URL
)

Details

Attachments

(1 file)

Rhino History upgraded webpage
2.55 KB, text/html
Details
Norris, I wish to upgrade all of the Rhino webpages to meet the m.o. requirements (validation, semantic markup, style, accessibility) and m.o. guidelines given by mozilla.org Markup Reference http://www.mozilla.org/contribute/writing/markup mozilla.org Documentation Style Guide http://www.mozilla.org/contribute/writing/guidelines All of the Rhino project webpages use an invalid doctype declaration taken from Netscape Navigator (Composer) 4.x (Mozilla/4.7 [en] (WinNT; I) [Netscape]): <!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en"> or <!doctype html public "-//w3c//dtd html 4.0 transitional//en"> I will use the CSS classes as given in mozilla.org Markup Reference. I will use <link rel="..."> (for site navigation toolbar) and crumbs navigation for intra-project navigation. <blockquote><tt>... will be replaced accordingly with <pre class="code"> <script> var d = new Date(document.lastModified); document.write((d.getMonth()+1)+"/"+d.getDate()+"/"+d.getFullYear()); document.write('<br>'); </script> would be removed since the server adds the last modified date at bottom of pages. Some Rhino webpages use <font> which is a big "no-no": e.g.: http://www.mozilla.org/rhino/debugger.html There are Rhino webpages with empty anchors: <a name="..."></a> &nbsp; and <br> left by Composer would be removed. In many Rhino webpages, there are many <tt> which are used for providing code and code chunks. "use <pre> if you need to; not <tt>" http://www.mozilla.org/contribute/writing/guidelines#format "In most cases, use of a phrase element such as CODE, SAMP, or KBD is more appropriate [better semantic] since these elements express the meaning of the text more clearly." http://www.htmlhelp.org/reference/html40/fontstyle/tt.html There are also many <blockquote> used to indent a block of text or code; this is not best semantic markup. Do you mind if I remove the "Back to top" links because <h3> adds an horizontal line which is duplicate by the code. E.g.: <h3> <hr width="100%"><br> <a href="index.html">back to top</a> </h3> The webpages aimed by this bug report are: http://www.mozilla.org/rhino/ http://www.mozilla.org/rhino/download.html http://www.mozilla.org/rhino/doc.html http://www.mozilla.org/rhino/history.html http://www.mozilla.org/rhino/help.html http://www.mozilla.org/rhino/users.html http://www.mozilla.org/rhino/overview.html http://www.mozilla.org/rhino/limits.html http://www.mozilla.org/rhino/changes.html http://www.mozilla.org/rhino/opt.html http://www.mozilla.org/rhino/faq.html http://www.mozilla.org/rhino/scriptjava.html http://www.mozilla.org/rhino/perf.html http://www.mozilla.org/rhino/shell.html http://www.mozilla.org/rhino/debugger.html http://www.mozilla.org/rhino/jsc.html http://www.mozilla.org/rhino/tutorial.html (69 validation markup errors; 137 validation markup errors with HTML 4.01 strict) http://www.mozilla.org/rhino/scopes.html http://www.mozilla.org/rhino/serialization.html http://www.mozilla.org/rhino/footprint.html http://www.mozilla.org/rhino/bsf.html This webpage http://www.mozilla.org/rhino/ScriptingJava.html has a charset encoding problem Norris, if you prefer to do this, that's also fine with me.
Hardware: PC → All
Status: NEW → ASSIGNED
Assignee: nobody → bugzilla
Status: ASSIGNED → NEW
-> me I will line-wrap the code to ~= 70 characters when upgrading the webpages.
Status: NEW → ASSIGNED
Checking in mozilla-org/html/rhino/download.html; /cvsroot/mozilla-org/html/rhino/download.html,v <-- download.html new revision: 1.32; previous revision: 1.31 done Converted to HTML 4.01 strict; removed 4 validation markup errors; charset was set to iso-8859-1; added 2 sections, reachable via Site Navigation toolbar; added intra-project [crumbs] navigation; removed "back to top" link; tweaked a few links. ---------------- Checking in mozilla-org/html/rhino/doc.html; /cvsroot/mozilla-org/html/rhino/doc.html,v <-- doc.html new revision: 1.19; previous revision: 1.18 done Converted to HTML 4.01 strict; removed 3 validation markup errors; added intra-project [crumbs] navigation; added anchors to <h2>eadings; "back to top" link removed.
Some abbreviations would be nice to be <dfn>-ed, especially at the first occurence in a document. E.g. in this manner: <dfn>Java Runtime Environment (JRE)</dfn> <dfn>Software Development Kit (SDK)</dfn> <dfn>Java Development Kit (JDK)</dfn> <dfn>Java Virtual Machine (JVM)</dfn> I'm not 100% sure what JIT means: Just-In-Time? Just-In-Time compilation? Just-In-Time execution? Webopedia suggests Just-In-Time compiler
Checking in mozilla-org/html/rhino/help.html; /cvsroot/mozilla-org/html/rhino/help.html,v <-- help.html new revision: 1.9; previous revision: 1.8 done Converted to HTML 4.01 strict; removed 12 validation markup errors; added intra-project [crumbs] navigation; added anchors to <h2>eadings. ---------------- Checking in mozilla-org/html/rhino/users.html; /cvsroot/mozilla-org/html/rhino/users.html,v <-- users.html new revision: 1.18; previous revision: 1.17 done Converted to HTML 4.01 strict; removed 6 validation markup errors; added intra-project [crumbs] navigation; added missing trailing slash "/" to a few urls; some redirected links have been updated, while some others have not; http://www.tdiinc.com/ no longer exists; XPPoint (http://www.xypoint.com/) redirected to http://www1.telecomsys.com/ but without the W3C link checker reporting this ... I don't know why; semantically speaking, several <p> would benefit from being converted into <blockquote>. This document could still be improved ---------------- Checking in mozilla-org/html/rhino/overview.html; /cvsroot/mozilla-org/html/rhino/overview.html,v <-- overview.html new revision: 1.7; previous revision: 1.6 done Converted to HTML 4.01 strict; removed 2 validation markup errors; added intra-project [crumbs] navigation; converted a few <tt> into <code>; removed "back to top" link. ---------------- Checking in mozilla-org/html/rhino/limits.html; /cvsroot/mozilla-org/html/rhino/limits.html,v <-- limits.html new revision: 1.5; previous revision: 1.4 done Converted to HTML 4.01 strict; removed 18 validation markup errors; implemented intra-project [crumbs] navigation; <link rel="section">s also added; removed "back to top" link. Some readers might find useful that some abbreviations to be <dfn>-ed at first occurence in document, like JIT, JRE, SDK, JDK.
Checking in mozilla-org/html/rhino/changes.html; /cvsroot/mozilla-org/html/rhino/changes.html,v <-- changes.html new revision: 1.23; previous revision: 1.22 done Converted to HTML 4.01 strict; removed validation markup errors; implemented intra-project [crumbs] navigation; changed charset from us-ascii to iso-8859-1; removed "back to top" link. ---------------- Checking in mozilla-org/html/rhino/opt.html; /cvsroot/mozilla-org/html/rhino/opt.html,v <-- opt.html new revision: 1.3; previous revision: 1.2 done Converted to HTML 4.01 strict; removed 2 validation markup errors; implemented intra-project [crumbs] navigation. ---------------- Checking in mozilla-org/html/rhino/faq.html; /cvsroot/mozilla-org/html/rhino/faq.html,v <-- faq.html new revision: 1.7; previous revision: 1.6 done Converted to HTML 4.01 strict; removed 20 validation markup errors; implemented intra-project [crumbs] navigation. Converted <p><b><font size="+2">Q</font>.</b> <i> into <dl>. Removed "back to top" link. ---------------- Checking in mozilla-org/html/rhino/scriptjava.html; /cvsroot/mozilla-org/html/rhino/scriptjava.html,v <-- scriptjava.html new revision: 1.14; previous revision: 1.13 done Converted to HTML 4.01 strict; removed 7 validation markup errors; implemented intra-project [crumbs] navigation and a few <link rel="section">. Removed/converted many <tt> into <code>.
Checking in mozilla-org/html/rhino/perf.html; /cvsroot/mozilla-org/html/rhino/perf.html,v <-- perf.html new revision: 1.2; previous revision: 1.1 done Converted to HTML 4.01 strict; removed 2 validation markup errors; implemented intra-project [crumbs] navigation and 4 <link rel="section">; removed back to top link.
Checking in mozilla-org/html/rhino/shell.html; /cvsroot/mozilla-org/html/rhino/shell.html,v <-- shell.html new revision: 1.9; previous revision: 1.8 done Converted to HTML 4.01 strict; removed 93 validation markup errors; implemented intra-project navigation and <link rel="...">; improved considerably the semantic of markup. ---------------- Checking in mozilla-org/html/rhino/debugger.html; /cvsroot/mozilla-org/html/rhino/debugger.html,v <-- debugger.html new revision: 1.12; previous revision: 1.11 done Converted to HTML 4.01 strict; removed 115 validation markup errors; implemented itnra-project navigation and <link rel="section">; improved considerably the semantic of the markup.
Checking in mozilla-org/html/rhino/jsc.html; /cvsroot/mozilla-org/html/rhino/jsc.html,v <-- jsc.html new revision: 1.6; previous revision: 1.5 done Converted to HTML 4.01 strict; removed 16 validation markup errors; implemented intra-project navigation. ---------------- Checking in mozilla-org/html/rhino/tutorial.html; /cvsroot/mozilla-org/html/rhino/tutorial.html,v <-- tutorial.html new revision: 1.9; previous revision: 1.8 done Converted to HTML 4.01 strict; removed 137 validation markup errors; implemented intra-project navigation; removed many dozens of <font>, <dir>, <tt>; implemented <pre class="code java_js_code">.
Checking in mozilla-org/html/rhino/scopes.html; /cvsroot/mozilla-org/html/rhino/scopes.html,v <-- scopes.html new revision: 1.8; previous revision: 1.7 done Converted to HTML 4.01 strict; removed 26 validation markup errors; implemented intra-project navigation. ---------------- Checking in mozilla-org/html/rhino/serialization.html; /cvsroot/mozilla-org/html/rhino/serialization.html,v <-- serialization.html new revision: 1.2; previous revision: 1.1 done Converted to HTML 4.01 strict; removed 7 validation markup errors; implemented intra-project navigation.
Checking in mozilla-org/html/rhino/footprint.html; /cvsroot/mozilla-org/html/rhino/footprint.html,v <-- footprint.html new revision: 1.8; previous revision: 1.7 done Converted to HTML 4.01 strict; removed 2 validation markup errors; implemented intra-project navigation. ---------------- Checking in mozilla-org/html/rhino/bsf.html; /cvsroot/mozilla-org/html/rhino/bsf.html,v <-- bsf.html new revision: 1.8; previous revision: 1.7 done Converted to HTML 4.01 strict; removed 2 validation markup errors; implemented intra-project navigation. ---------------- Checking in mozilla-org/html/rhino/ScriptingJava.html; /cvsroot/mozilla-org/html/rhino/ScriptingJava.html,v <-- ScriptingJava.html new revision: 1.5; previous revision: 1.4 done Converted to HTML 4.01 strict; removed 4 markup errors; implemented intra-project navigation. ------ I still need to re-check a few issues in a few webpages.
Remaining to do: runtime.html and examples.html
Checking in mozilla-org/html/rhino/runtime.html; /cvsroot/mozilla-org/html/rhino/runtime.html,v <-- runtime.html new revision: 1.6; previous revision: 1.5 done Converted to HTML 4.01 strict; removed 4 markup errors; implemented intra-project navigation. ---------------- Checking in mozilla-org/html/rhino/examples.html; /cvsroot/mozilla-org/html/rhino/examples.html,v <-- examples.html new revision: 1.10; previous revision: 1.9 done Converted to HTML 4.01 strict; removed 2 markup errors; implemented intra-project navigation.
Note that the file http://www.mozilla.org/rhino/history.html can not be updated/upgraded.
I'm attaching the edited Rhino History webpage http://www.mozilla.org/rhino/history.html that I couldn't submit (wasn't able to) via Doctor interface.
Norris, In the page http://www.mozilla.org/rhino/users.html the link XYPOINT is redirected and webwirelessnow is a domain name for sale. Both links are redirected and wrong, IMO. So somehow, the related content should be updated or taken care of. In the page http://www.mozilla.org/rhino/runtime.html there is the link ScriptableObject.defineClass() which is working but syntaxically incorrect. I can't fix that link without fixing how the anchor was created in the target document. Resolving as FIXED
Status: ASSIGNED → RESOLVED
Closed: 18 years ago
Resolution: --- → FIXED
Looks like that's a bug with doctor that it doesn't find that rhino/history.html exists. I checked it in directly to CVS. You might want to file a bug for that. Checking in history.html; /cvsroot/mozilla-org/html/rhino/history.html,v <-- history.html new revision: 1.3; previous revision: 1.2 done
Status: RESOLVED → VERIFIED
> I checked it in directly to CVS. Thank you, Nicholas. I appreciate your assistance! > You might want to > file a bug for that. Done: bug 361167
Product: mozilla.org → Websites
Component: www.mozilla.org → General
Product: Websites → www.mozilla.org
You need to log in before you can comment on or make changes to this bug.

Attachment

General

Creator:
Created:
Updated:
Size: