|
History
| Log In
|
|
|
|
I'm going to take this because it looks like it's going to be a regexp/perl kind of solution, not a docbook solution, and I really want to do it.
Partial fixes in r6313:
Change 20070831-ben-S by ben@slim.local on 2007-08-31 15:54:42 PDT in /Users/ben/src/svn/openlaszlo/branches/wafflecone-doctools/docs for http://svn.openlaszlo.org/openlaszlo/branches/wafflecone/docs Summary: Add CSS to make don't-read-this snippet in ref guide obnoxiously pink New Features: Bugs Fixed: Technical Reviewer: frisco QA Reviewer: frisco (pending) Doc Reviewer: frisco (pending) Documentation: This change adds two CSS styles to the lzx stylesheet used in the reference guide, to make the "don't-read-this" snippet be pink, in order to draw attention to itself. This will not change the way anything looks until something with class="warningheader" is inserted into the ref guide, which is happening separately, elsewhere. Release Notes: This style can be removed after wafflecone. Details: Tests: Change to docs/src/build.xml sent to ptw for review.
Change 20070904-ben-t by ben@slim.local on 2007-09-04 10:52:29 PDT in /Users/ben/src/svn/openlaszlo/branches/wafflecone for http://svn.openlaszlo.org/openlaszlo/branches/wafflecone Summary: Add a doc build step to insert a disclaimer New Features: Bugs Fixed: Technical Reviewer: ptw QA Reviewer: mkratt (pending) Doc Reviewer: sundman (pending) Documentation: This change adds a step to the documentation build process to insert a disclaimer into every page of the reference manual saying, roughly, please go use the 3.4 reference. After building the whole docs, it calls the new ant target "reference.html.disclaimer" which in turn calls a shell script in $LZ_TOOLS_ROOT which inserts the disclaimer right after the header in every reference page. This change should NOT be merged back to legals; it should ONLY be in wafflecone for the 4.0.5 release. The script invoked by this change is checked in to http://svn.openlaszlo.org/tools/trunk/injector/injector.sh Release Notes: Details: Tests: ant doc Look at http://localhost:8080/wafflecone/docs/reference/index.html it should have a big pink disclaimer at the top. Verified in 4.0.6 release that the header exists in the Developer's Guide.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||
 |
|
Task
Closed
P1
Put in a header in each page of reference guide saying "this is an alpha; please look elsewhere(link) for better docs"
"The OpenLaszlo 4.x Reference Manual is alpha quality. The information on this page is believed to be correct, but some information may be missing. We recommend using the OpenLaszlo 3.4 Reference Manual, since the APIs are essential identical between OL 3.4 and OL 4.x. The OpenLaszlo 4.0.5 Developer's Guide should be used in preference to the OL 3.4 Developer's Guide, however."
Something like that?