Except for this text in blue, this document an
example of how we want the What's New
web page to look. We need to
make these changes before we can add a "What's New" link to the standard
navigation aids on the Artemis Project web.
The key changes include:
- Display linked section numbers and document titles instead
of just file names.
- If nothing changed on a given day, don't output anything.
- Use the WebSite Director document templates so that the
What's New list has the same appearance as the rest of the
Artemis Project web.
- Don't use big black bullets in the list. Instead of an
unordered list, use block quotes and tables to control
the formatting.
- Don't abbreviate the names of days or months, and don't
output the time in the middle of the date.
- Use specific formatting rather than header tags to control the
format of the internal subtitles
- Include a note that tells whether a document was added or modified.
- Don't output horizontal rules between days.
- Use a list of files and whole directories to be excluded from the
What's New list. We need to be able to update the list with the
normal WebSite Director process flow, so read it from a text
file in /util/ or /whatsnew/. That list would include these
files, among others:
/index.html
/adb/06/09/04/currentnews.html
- Set the Author to "Whatsnew" and Maintainer to "WebSite Director"
- Limit the output to no more than 40 documents listed for any
single day, and limit the total size of the output file to
50K. This accommodates massive updates. Otherwise, let the
list grow to encompass all changes made in the previous 14 days.
If the number of files changed on a single day exceeds the limit,
add a note at the end of the list for that day: ... and many
others.
For the sake of laziness, the example below lists exactly the same files
for each of three days in the history of the Artemis Project's
conquest of the moon.