On Thu, 2006-10-19 at 18:41 +0200, Nicolas Maufrais wrote: > There are no screenshots in this manual. Screenshots become obsolete > quickly and as a result confuse the users. What looks one way in a > screenshot will always look different in the real program because the > real program and the manual are always evolving, never perfectly > synchronized. It is true that manuals should have screenshots, but our > objective in omitting screenshots is to keep the software costs minimal > so you don't have to pay for it. That includes additional labor to > synchronize the manual with the software.
I consider above very important in the sense that I have opinion that user-manual should include screenshots and images. > I prefer to use good tools which already proved their quality than > something else which isn't widely used, and probably not as good. Me too. > I'm not quite sure the "markup-training" is that hard for texinfo. Look > at the cinelerra.texi file, and look at the tags. Here they are [snip] > There are only 25 tags, some of them being used just 1 time. Moreover, I > think they're quite easy to dig... Then we can use LaTeX or even LyX as well. > IMO, there's nothing more "classy" than a documentation made from > texinfo. It's simple, well arranged, and easy to read. Well, we can the use also groff, but nothing comes close to tex-engine when typesetting is concerned. My point of using txt2tags is to have easy entry-level document which can be easily (automatically) converted to both XHTML - to be used via Help button - and PDF - via LaTeX. > Using the wiki as it is for the moment is a real pain. I mean, the work > that Alex did is very nice indeed. But the server is sooooooo slow! It's > a real pain to edit anything! I agree. > The next step IMO should be to merge the Wiki and Secrets into 1 large > document. That would be the definite reference to look at when looking > for information. The wiki will continue, for sure, but its contents > would be integrated into that large manual. We have to agree on the format first. > Cinelerra documentation really need to be improved, and having all the > information splitted over several places brings confusion. Here we (all ?) agree. Sincerely, Gour
signature.asc
Description: This is a digitally signed message part
