November 2011 - docs - lists.mariadb.org

[Maria-docs] Stub content on KB?
by Shaun McCance 09 Dec '11

09 Dec '11

Hi all, What are your thoughts on adding stub articles/sections to the KB? For example, adding an article for how to specify account names without actually writing the content, along with a note to whoever comes along about what the article should contain. I've seen stubs work well in other docs efforts. They're an easy way for contributors to cherry pick work. But with the "everything is always published" model of a wiki-like KB, stubs can be annoying to average readers, like a 90s-esque "under construction" banner. Thoughts? -- Shaun

6 16

[Maria-docs] Parent Categories
by Shaun McCance 06 Dec '11

06 Dec '11

How are parent categories set for articles in the KB? For example, this page has two parents: http://kb.askmonty.org/en/rename-table But I don't see on the edit page how those parents are set. I think the CREATE TABLE page ought to be under "Table commands" as well as CREATE, but I don't know how to do that. Also, when a page has multiple parents, the bread crumbs at the top only reflect one parent. Is there a primary parent? Why not show them for each parent? The bread crumbs are much more visible than the small Parents links in the sidebar. (The downside is that you have to deal with multiple parents of all ancestors, which can lead to an explosion of links if you're not careful with categorization.) -- Shaun

3 2

[Maria-docs] KB organization suggestion: "help contents" category
by Daniel Bartholomew 28 Nov '11

28 Nov '11

All, Some of the content in the KB is taken from the mysql help tables (viewed using the "help" command in the mysql client application). I have a suggestion from one user to create a "help contents" category. This category would list the subcategories as they appear in the mysql client when you issue that command and so on down through all of the content in the mysql help tables. Does anyone have any objections to doing this? I'm not convinced that it is something we should absolutely do, but I'm not really opposed to it either. In its favor, it would present the content in a way that is familiar to those who have used the help command, and so it would make that content more discoverable. Opinions? Comments? Thanks. -- Daniel Bartholomew MariaDB - http://mariadb.org Monty Program - http://montyprogram.com AskMonty Knowledgebase - http://kb.askmonty.org

1 0

[Maria-docs] Aria storage engine docs are not up to date
by Philip Stoev 28 Nov '11

28 Nov '11

Hello, I guy complained that our Aria documentation is not up to date. This KB page: http://kb.askmonty.org/en/aria-faq - discusses a file (KNOWN_BUGS.txt) that is nowhere to be found. Some other KB articles also mention it; - it is difficult to figure out what features have been implemented already and which release they could be found. The person is from the MySQL ecosystem, and therefore has at least some idea about what is going on, so I assume that for someone who is totally unaquainted with the situation, the text will be even more confusing. I also noticed that this page: - Discusses Aria in terms of MySQL 5.1 release and not in MariaDB release numbers; - contains links to MySQL forge and not our own WL system Philip Stoev

2 1