Forum OpenACS Development: Re: 4.6.x Documentation; Documentation formatting
Those sound like really useful additions indeed!
To comment on your questions:
2) Personally, I think I prefer the current style (probably mostly because I've grown acustomed to it). I find the new style a little muddled 😊
3) Hmm.. I can see your point that cutting/pasting should be easy. However, I think we ought to focus on readability, and keeping the prompts makes it much easier for the installer to realize from where and as which user a certain command should be issued. The "first-timer" is probably more anxious about gaining understanding of what's going on during the installation than (s)he is about gaining time.
4) I don't think anyone will object to this.
In my Windows install documents, I took a
cut-and-paste approach, and it has been very useful. You can put comments in with, e.g.
# Aren't you glad you can cut-and-paste this command? /usr/local/bin/tcpserver -x /etc/tcp.smtp.cdb -v -u 502 -g 501 0 smtp /var/qmail/bin/qmail-smtpd 2>&1 | /var/qmail/bin/splogger smtpd 3 &
You could make commands and comments different colors, white and green perhaps. Of course you would still lose any inlined output and prompt information as Ola mentioned. Thanks for working on this!
I am a big fan of cut and paste things as well. One example of something we might consider is the oracle setup statements page that Lars did. I use it all the time...