Gervase Markham wrote:
>
> > http://fantasai.tripod.com/Mozilla/2000/reorg.txt
>
> What's the difference between /docs, /projects/docs and
> /projects/project_name/docs? Too many docs directories :-)
Well.. it needs work. ^^
/docs contains or references (mostly references) _all_ the
documentation on mozilla.org. Possibly it can be a single HTML
file such as the one there right now. This is for an everything-
in-one place organization. It includes developer, web-developer,
and user documentation (or rather, indexes and links to the
appropriate files)
/projects/docs holds any documentation pertaining to all
the projects. /docs/developer could do the same job; I'll
change it if you think I should.
Files that might go in there or in a subdirectory of it:
http://www.mozilla.org/build/verification.html
http://www.mozilla.org/build/making-additions.html
http://www.mozilla.org/build/jar-packaging.html
http://www.mozilla.org/build/sheriff.html
http://www.mozilla.org/docs/lxr-comments.html
http://www.mozilla.org/docs/refList/i18n/
http://www.mozilla.org/docs/events.html
http://www.mozilla.org/hacking/
http://www.mozilla.org/hacking/portable-cpp.html
I think I'll stop now...
/projects/project_name/docs contains project-specific documentation.
This is pretty much what we have now, except that right now,
half the projects are in the projects directory, and half of
them are top-level. *_*
> Why is mozilla not a project? Why have another directory called software?
> Aren't projects software?
mozilla can be a project; I didn't exclude it.
/projects is a developer directory.
The directory called software holds everything related to software
*releases*, not development. Should I rename it to /releases?
It's somewhat redundant with mozilla/releases, but that can be changed
to relnotes if there's nothing except relnotes associated with a
given release. (Every doc issued with/for a release should be archived.)
>
> Why are tools not projects (most of them are in the current structure.)
> Where's the division between tool and project?
Development of tools goes under projects--bugzilla will have its
own project directory. The /tools directory is for using the tools.
Stuff like
http://www.mozilla.org/bugs/
http://www.mozilla.org/quality/help/bugzilla-helper.html
http://www.mozilla.org/bonsai.html
http://www.mozilla.org/tinderbox.html
all go in /tools.
