My Sphinx documents use a Sphinx-type table of contents at the top of the tree, a hierarchy of rst files, and inter-file links. Nothing more complicated. The content includes text, code snippets, entire small programs, output captures formatted as plain mono-spaced text, and images. I don't use anything more complex, and until a few days ago was not aware that you could do anything more complicated with rst3.
So when you are done with the revamped rst3, I want to be able to run it on my tree and get Sphinx-ready output, just like you can get currently. If that will work, I will be happy. If it won't, I will probably have to do a lot of work to be able to generate my documentation, and I won't like that. On Saturday, March 27, 2021 at 5:37:39 PM UTC-4 Edward K. Ream wrote: > On Saturday, March 27, 2021 at 11:52:00 AM UTC-5 [email protected] wrote: > > Everything you say you want to achieve could be done by leaving rst3 as is >> - never touching it again - and creating a new rst4. It would be no more >> work, and there would be no latent backwards compatibility issues. >> > > There are costs associated with doing nothing, some of which I've > mentioned: learning costs for newbies and maintenance costs. > > There are several other costs of doing nothing. Call them "opportunity > costs" if you like: > > - The design and code of rst3 are poor adverts for Leo. > - rst3 leads our thoughts astray. The rst3 command should *handle* > content, not *manufacture* content. > - A clearer view of rst3 will encourage those with advanced needs to write > simple scripts to create the content they want. > > *Summary* > > We must not rationalize past mistakes. Progress happens by learning from > those mistakes and moving on. > > I've ripped out major projects before. Leo is stronger without Qt docks, > and Leo will be stronger with a simplified rst3 command. > > Imo, an rst4 command would increase confusion. The rst3 command (and its > horrendous docs) would be an ongoing distraction. > > I'd like to hear now from those who actually use the "advanced" features > of rst3. > > Edward > -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/leo-editor/2aea72cf-1f9a-4274-952d-2632955f4615n%40googlegroups.com.
