embedded systems

From Gentoo Wiki
Jump to:navigation Jump to:search

Is there a reason why categorizing embedded devices is so different from categorizing everything else? Even the naming convention is different. Doesn't it destroy the idea of categories? People have to specify the boards in two articles manually: <a href="/wiki/Embedded_Handbook/Boards" title="Embedded Handbook/Boards">here</a> and <a href="/wiki/Embedded_Handbook#Boards" title="Embedded Handbook">here</a>. And the number of the articles does not even match. I came across this completely by accident, it's not documented anywhere. Even the <a href="/wiki/Gentoo_Wiki:Article_Blueprints/Hardware/Embedded" title="Gentoo Wiki:Article Blueprints/Hardware/Embedded">blueprint</a> does not say anything about it. There are dozens of articles that don't get there because people are confused.

In my opinion, names in form Embedded_Handbook/Boards/Pine64/QuartzPro64 should be avoided by four reasons:

  1. All Board articles are independent articles and they are not part of the <a href="/wiki/Handbook:Main_Page" title="Handbook:Main Page">Handbook</a>. By including an article in the Handbook namespace, others may think that the articles are written by Gentoo developers, and that's wrong. Most of the articles are provided AS IS, without any audit. The Handbook should remain generic, laptop pages are not part of the Handbook, so why should boards be?
  2. Long names separated by slashes are hard to read.
  3. Manual categorization will never work.
  4. Some official names include slashes (e.g. <a href="/wiki/Embedded_Handbook/Boards/QNAP_TurboStation_109/209/409" title="Embedded Handbook/Boards/QNAP TurboStation 109/209/409">Embedded_Handbook/Boards/QNAP_TurboStation_109/209/409</a> - others may treat QNAP_TurboStation_109 and 209 as categories).

I suggest categorizing everything like <a href="/wiki/Category:Laptops" title="Category:Laptops">Category:Laptops</a>.