On Tue, 2 Apr 2013 09:38:44 +0200 Sergei Golubchik <[email protected]> wrote:
> Hi, Daniel! Hello! > On Apr 01, Daniel Bartholomew wrote: > > Ian Gilfillan <[email protected]> wrote: > > > > > I have a question on the "SQL-99 Complete, Really" section > > > of the documentation. This is the complete copy of the > > > book. Is the aim to keep this as a clean copy of the book > > > (in which case the text should be left untouched), or to > > > edit as necessary? > > > > > > As an example, I want to add details about the > > > completion_type system variable to the COMMIT TRANSACTION > > > page. There's almost no info in the non SQL-99 section of > > > the docs. > > > > > > So, which way should I go about it: > > > > > > 1) edit the SQL-99 COMMIT TRANSACTION page? > > > 2) create a new COMMIT TRANSACTION page or similar in the > > > transaction section of the main docs, and add details there? > > > > Yes, the idea is to have a complete, clean copy of the book, > > but we can pull anything we want from it into the MariaDB > > section and customize the info for MariaDB. So go with option > > 2. > We could also have something like "See also", say, a text like > "For MariaDB extensions to this syntax ..." or "MariaDB related > information ..." and links to the relevant pages. In a slug on > top of the page or in the sidebar. Somewhere that is clearly > distinct from the book text and doesn't blend with it, but > still allows readers to get to the MariaDB pages quickly. Yes, that's a good idea, adding some content using one of the box styles would be fine. Something like the following placed either at the very top or at the bottom after the <<booknav>> macro: <<style class="greenbox">> Extra content, links, and etc... <</style> Thanks. -- Daniel Bartholomew Google+ - http://gplus.to/dbart Twitter - http://twitter.com/daniel_bart MariaDB: An Enhanced Drop-in Replacement for MySQL Website - http://mariadb.org Twitter - http://twitter.com/mariadb Google+ - http://google.com/+mariadb Facebook - http://fb.com/MariaDB.dbms Knowledgebase - http://kb.askmonty.org Monty Program - http://montyprogram.com _______________________________________________ Mailing list: https://launchpad.net/~maria-docs Post to : [email protected] Unsubscribe : https://launchpad.net/~maria-docs More help : https://help.launchpad.net/ListHelp
