See comments below.
On Oct 5, 2010, at 10:25 AM, Tim Donohue wrote:
> It's worth mentioning that obviously we can work on new Documention in the
> regular area of the DSpace wiki as well
> (https://wiki.duraspace.org/display/DSPACE/). In fact, we may want to
> suggest that as a "best practice", and in order to keep the official
> documentation "clean", all unfinished or in-progress documentation should
> initially be built on the regular Wiki. Once it is "ready for release", it
> can then be moved into the official Wiki Documentation area. That may help us
> avoid having too much "unfinished" documentation appearing in the official
> area (which would just look bad and would clutter things up).
>
Absolutely. Best practice there. I like that idea.
> In other words, Jeff we may want to establish some general policies about how
> to work with the wiki docs. As our official "Doc Guru", I think these should
> be approved or suggested by you, based on how you see this process working
> best.
>
You've just given me the impetus to write some editorial guidelines and have
that as part of the confluence documentation. It really will be
a codification of what I had been doing in Docbook.xml, and but will also
assist me and others in consistency.
> A very basic example could be:
> * Making a small/minor change -- we suggest editing directly in Primary Docs
> area
> * Building new docs around a new feature -- we suggest initially create these
> docs on DSpace wiki. Move them over to Primary Docs area once the new
> feature is ready to be released (i.e. once the feature has been added to
> trunk).
Yes, we're starting to all be on the same page about this. Next week, I have
some time I can set aside and begin the the task of getting this ready to go so
that the Committers can write away, and the editors can edit and the official
documentation stay more or less pristine (that was pristine
not prissy!).
Some of the documentation, yet to be written, will be influenced by "Best
Practices" and by "hints and tricks" that will make the administrator and
associated programmers' lives a little easier in bringing up a new instance of
DSpace and the Upgrade process will be easier.
Jeffrey Trimble
Systems Librarian
William F. Maag Library
Youngstown State University
[email protected]
http://www.maag.ysu.edu
http://digital.maag.ysu.edu
"The spice must flow ... "
------------------------------------------------------------------------------
Beautiful is writing same markup. Internet Explorer 9 supports
standards for HTML5, CSS3, SVG 1.1, ECMAScript5, and DOM L2 & L3.
Spend less time writing and rewriting code and more time creating great
experiences on the web. Be a part of the beta today.
http://p.sf.net/sfu/beautyoftheweb
_______________________________________________
Dspace-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/dspace-devel
