On Wednesday 29 July 2009 00:37:45 Roger Binns wrote:
> Santiago Suarez Ordoñez wrote:
> > I'm sorry I never got the time to try it myself, but you can test it
> > using Selenium's doc:
>
> Roberto's problem is that he doesn't have source documents with every
> Sphinx/RST feature in them.  So each time he uses source from a project,
> someone on that project has to manually proof read the output looking for
> issues, and that still doesn't mean that all functionality is rendered
> correctly. As an example when he was working with APSW doc there were
> several new previously untested constructs that had to be fixed, and not
> doubt there are others out there.

Right. And also, it helps if it' s not too repetitive. 

I mean, I have the (currently) 700 page Django guide. I am sure almost 
everything *is* there, but I don' t know where, and I don' t know how it' s 
supposed to look like because I would have to compare rst2pdf, latex and html 
to see how each does each thing.

Then when I change something, I need to restart from the beginning to be sure 
I am not breaking stuff that used to work.

-- 
 ("\''/").__..-''"`-. .         Roberto Alsina
 `9_ 9  )   `-. (    ).`-._.`)  KDE Developer (MFCH)
 (_Y_.)' ._   ) `._`.  " -.-'  http://lateral.netmanagers.com.ar 
  _..`-'_..-_/ /-'_.'     The 6,855th most popular site of Slovenia   
(l)-'' ((i).' ((!.'       according to alexa.com (27/5/2007) 

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to 
[email protected]
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to