[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

From |
Nick Winter <nwinter@virginia.edu> |

To |
statalist@hsphsun2.harvard.edu |

Subject |
Re: st: re: TeX template for PDF help files |

Date |
Mon, 23 Nov 2009 09:30:57 -0500 |

- Nick Winter Maarten buis wrote:

--- On Mon, 23/11/09, Roy Wada wrote:I thought about the translator thing, and this should notbe difficult. I also see that the Stata Corp is silent onthis issue.Probably because the entire discussion took place over the weekend.If you look at the official help files they avoid writing too much and use small paragraphs only. Users don't know this, and they cram too much, and it starts looking hideous This is how people get sucked into putting hours and hoursof work with nothing to show for it.My analysis would be different: StataCorp has always had the paper manual, so the help files were just there as a quickreference, hence the short paragraphs containing only basicinformation (there are exceptsions, see for example-help classman- or -help dialog_programming-).We could also mantain two sets of documentation, but it iseasier to maintain 1 document rather than 2. I have playedaround with that two level documentation format, but I foundit too much work and too easy to get inconsitencies acrossdocumentations. So, I will stick with using smcl help files.-- Maarten -------------------------- Maarten L. Buis Institut fuer Soziologie Universitaet Tuebingen Wilhelmstrasse 36 72074 Tuebingen Germany http://www.maartenbuis.nl --------------------------* * For searches and help try: * http://www.stata.com/help.cgi?search * http://www.stata.com/support/statalist/faq * http://www.ats.ucla.edu/stat/stata/

-- -------------------------------------------------------------- Nicholas Winter 434.924.6994 t Assistant Professor 434.924.3359 f Department of Politics nwinter@virginia.edu e University of Virginia faculty.virginia.edu/nwinter w PO Box 400787, 100 Cabell Hall Charlottesville, VA 22904 * * For searches and help try: * http://www.stata.com/help.cgi?search * http://www.stata.com/support/statalist/faq * http://www.ats.ucla.edu/stat/stata/

**References**:**Re: st: re: TeX template for PDF help files***From:*Maarten buis <maartenbuis@yahoo.co.uk>

- Prev by Date:
**Re: st: biprobit with partial observability** - Next by Date:
**st: re: TeX template for PDF help files** - Previous by thread:
**Re: st: re: TeX template for PDF help files** - Next by thread:
**st: re: TeX template for PDF help files** - Index(es):

© Copyright 1996–2016 StataCorp LP | Terms of use | Privacy | Contact us | What's new | Site index |