Thema: | other |
Stand: | closed |
Priorität: | high |
I think we need an FAQ page. Currently it is not as easy as it should be for new users to get started with h-node. I thought a nice FAQ would improve the situation.
But what about our Help page? As it is, it doesn't help new users too much, I think. We should move all entries from our Help page to wiki and replace the Help page with an FAQ. By the way, I noticed that we have very similar entries both in the wiki and in the Help page: "Discover your hardware". The Help page's entry should be merged to the wiki anyway even without making an FAQ (why do we even have two of them? -> messy).
The new FAQ page would look something like this (PART 1):
(underlined text represents a link to other pages in or outside of h-node)
_______________________ home >> FAQ _______________________ This is h-node's FAQ. Please, read this page first before making your first contribution. You can also find more specific information from our wiki.Table of contents* What is h-node all about? * How can I help h-node to become a better site? * How can I find out if I have hardware which needs to be inserted to h-node? * How can I add new hardware to h-node? * What should I include in the devise's description? * How can I edit the device's description? * Why I can't use just any GNU/Linux distribution to test my hardware for h-node? * I have a piece of hardware that cannot be easily included into any category. What should I do? * How can I suggest new features to be implemented? * I think I have found a bug. What now? * Is there a mailing list I can join?What is h-node all about?The h-node project aims to create and maintain a comprehencive hardware database in order to identify what devices work with fully free operating systems and which do not. This way, it is more easier to find compatible hardware for the free software community. The h-node.org website is structured like a wiki so that all users can modify it and insert new content. The h-node project is developed in collaboration and as an activity of the Free Software Foundation.How can I help h-node to become a better site?You can contribute in many ways. The best way is to check what kind of hardware you have, wether they can be found in the database or not and insert new hardware to the database and update existing entries. You can also suggest new features to be added to h-node and report bugs and other issues in our Issues page. You can participate in discussion on various subject in our Issues page and in our mailing list. New contributions of any kind are most appreciated.How can I find out if I have hardware which needs to be inserted to h-node?Go to our Search page and follow the provided instuctions. You will get a list of your hardware where you can easily see what hardware needs to be added to the database. Please remember that even if all of your hardware is already in the database you should still check if the existing information is up to date or if you can provide any additional details. Others can report only that hardware they have, so your entries are precious.How can I add new hardware to h-node?If the hardware list you got from our Search page shows that you have some hardware that needs to be added to the database, you can easily add them one at a time by clicking the insert link next to the device's name in the list. This will take you to a page where you can easily add that particular piece of hardware to the database. You can find links to instructions on that page about how to provide answers to each field given.What should I include in the devise's description?You should include as much information as possible. A good habit is always to include relevant output from lspci -vmmnn and lspci -nnk commands, or if your device is a USB device, output from lsusb -v. You should also describe how easy it was to set up the device and does it work out of the box or does it require additional fiddling to work. Good examples can be found here and here. (http://www.h-node.org/printers/view/en/665/Deskjet-1050-J410-series/1/1/undef/undef/undef/undef/undef/undef) (http://www.h-node.org/scanners/view/en/229/CanoScan-LiDE-110)
3G cards | 34 |
Acquisition cards | 34 |
Bluetooth | 57 |
Ethernet cards | 172 |
Fingerprint readers | 11 |
Host Controllers | 170 |
Modems | 18 |
Notebooks | 793 |
Printers | 126 |
RAID adapters | 20 |
Scanners | 24 |
SD card readers | 57 |
Sound cards | 142 |
Video cards | 343 |
Webcams | 132 |
Wifi cards | 234 |
TOTAL | 2367 |