Clayton wrote:
Jean Hollis Weber wrote:
Clayton may correct me on this, but I believe that this page, and all
the associated PDF files, are on our list for migration to the wiki, as
part of a general rationalisation of the way documentation is provided.
That is, the user guides, like the developers' guides, will then be
available in downloadable form through the wiki... even though (at least
for the immediate future) the source docs for the UGs will continue to
be ODT files residing on the OOoAuthors website, with the the wiki
version derived from the ODT version instead of the other way around as
for the developers' guides.
It is definitely easier to maintain the content via a Wiki page vs the
older html page style (requiring CVS access etc.) We can upload the
ODTs and PDFs to the Wiki, and/or upload them to the OOoAuthors
repository (is there one?), and then link them via a master doc page -
the result is the same - a single page listing downloadable docs for an
OOo release family.
We can do the same from the main Documentation page.. instead of a link
to an html page listing the available docs, I can change that to a link
to the Wiki page (once it's in place) showing the same info.
Excellent! That would make my life SO much easier, not having to deal
with CVS (especially since I use multiple computers).
OOoAuthors does have a repository of sorts, but I think that website
is best kept as a workspace for people developing the user guides, and
avoid sending users there to collect documentation.
(We have not been allowed to put the ODT source files for the user
guides on the Docs website due to their CC:BY license, but we can put
them on the wiki along with the PDFs.)
Yesterday I started a discussion on the OOoAuthors list about some
technical/tracking problems associated with maintaining a set of
published docs accessible to the public. The only solution that has
occurred to me is cumbersome. Avoiding the problem is much better.
--Jean
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@documentation.openoffice.org
For additional commands, e-mail: dev-h...@documentation.openoffice.org
