[Opensource] Expresso documentation structure

[D Lloyd]

Sandra,

I did alot of the work with regurd to its current look and breaking it
into html files.  I can make the footer changes you would like when/if
these are decided upon.

As far as people wanting to use a tool, I don't see the problem.  I also
would like to see it kept in a nice readable format as I also edit it with
a simple text editor.  As a compromise to the group what does everyone
think about a pretty-text formatter tool for the XML so that it can be
edited with tools that do not format it nicely and then beautified before
check-in?  If no tool exists, I have written them for other XML formats
and could do the same, hopefully ;>  It is a matter re-marking it up based
on the DTD, which is why I have not found one in the past I have liked.  I
think it would also be nice if the beautification step worked consistently
enough that changes were easily differenced.

Any thoughts?

David Lloyd
d a v i d @ l l o y d h o m e . c o m

--- Sandra Cann <scann at jcorporate.com> wrote:
> I too would like to edit the EDG but do not want to in xml and hence
> there
> is a lot of editing I would do that just doesn't happen. I like Max's
> suggestions and as first steps I'd like to move the intro files on each
> component into the EDG. That would simplify the doc onsite
> significantly.
> 
> I'd also want to use an editor for the same reason Max expressed. 
> 
> Bottom Line - We are losing a lot of doc help from folks on EDG. So
> addressing that issue perhaps is important for the community. 
> 
> I took a look at xmlmind and it is quite snazzy. It has some advanced
> configuration features and I read in the tutorial a way to select
> special
> characters so I figure there is a way to replace all harder to
> understand
> codes " with &amp. Sounds like there is some learning curve involved
> but
> that this might offer a solution once explored. 
> 
> Is there someone that could help with getting us going on the EDG
> editing?
> 
> There are also some formatting suggestions so that it follows more
> closely
> the site .css as well as some ideas for the footer - but I don't want to
> step on anyone's toes. Who should I work with on this?
> 
> Sandra
> 
> _______________________________________________
> Opensource mailing list
> Opensource at jcorporate.com
> http://mail.jcorporate.com/mailman/listinfo/opensource
> Archives: http://mail.jcorporate.com/pipermail/opensource/


__________________________________
Do you Yahoo!?
Free Pop-Up Blocker - Get it now
http://companion.yahoo.com/