Home » Wiki » FAQ » History » Differences
Differences between the revision of 13:50, 22 July 2012, created by lammi87, and the revision of 20:00, 21 July 2012
Notice: the text in red has been deleted from the previous revision, the text in green has been added in this revision and the text in gray has not been changed.
differences in the entry: the title
differences in the entry: the text of the wiki page
[p]This is h-node's FAQ. Please, read this page first before making your first contribution. You can find more specific information from our [[Main Page|wiki]] pages.[/p]


[h3]What [h1]What is h-node all about?[/h3] about?[/h1]

[p]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 [a]http://www.fsf.org|Free Software Foundation[/a].[/p]

[h3]How [h1]How can I help h-node.org to become a better site?[/h3] site?[/h1]

[p]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 subjects in our Issues page and in our mailing list. You can also help in translating h-node to other languages. New contributions of any kind are most appreciated.[/p]

[h3]How [h1]How can I find out if I have hardware which needs to be inserted to h-node?[/h3] h-node?[/h1]

[p]Go to our [a]http://www.h-node.org/search/form/en|Search[/a] 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.[/p]

[h3]How [h1]How can I add new hardware to h-node?[/h3] h-node?[/h1]

[p]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 [b]insert[/b] 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 given field. [/p]

[h3]What [h1]What should I include in the devise's description?[/h3] description?[/h1]

[p]You should include as much information as possible. A good habit is always to include relevant output from [b]lspci -vmmnn[/b] and [b]lspci -nnk[/b] commands, or if your device is a USB device, output from [b]lsusb -v[/b]. 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 [a]http://www.h-node.org/printers/view/en/665/Deskjet-1050-J410-series/1/1/undef/undef/undef/undef/undef/undef|here[/a] and [a]http://www.h-node.org/scanners/view/en/229/CanoScan-LiDE-110|here[/a].[/p]

[h3]How [h1]How can I edit the device's description?[/h3] description?[/h1]

[p]The device's description sections supports many tags which help you to format the description to a clear and easy to read form. The same tags are used in our wiki too. Complete list of tags can be found [[wiki tutorial|here]]. A good habit is to use [b]{{p}}[/b] and [b]{{/p}}[/b] tags for paragraphs and [b]{{code}}[/b] and [b]{{/code}}[/b] tags for sections of code or output from lspci or lsusb commands.[/p]

[h3]Why [h1]Why I can't use just any GNU/Linux distribution to test my hardware for h-node?[/h3] h-node?[/h1]

[p]H-node's aim is to collect information about what hardware works with free software, so hardware must be tested with [a]http://www.gnu.org/philosophy/free-sw.html|free software[/a] only. We ask you to test your hardware with a fully free GNU/Linux distrubution to make sure the data we get is accurate. You can find a list of fully free GNU/Linux distributions [a]http://www.gnu.org/distros/free-distros.html|here[/a]. [[Fully free GNU/Linux Distributions|here]]. The list consists of distributions which are accepted as fully free (as in freedom) by the Free Software Foundation.[/p]

[p]The easiest method to test one's hardware is to burn a live cd/dvd of a fully free GNU/Linux distribution and use that as an operating system in live mode when testing. This way you don't have to install a fully free distribution to see if your hardware is compatible or not. [/p]

[h3]I [h1]I have a piece of hardware that cannot be easily included into any category. What should I do?[/h3] do?[/h1]

[p]We try to get any kind of hardware into the database which could be usefull to the free software community. We are still developing h-node and some categories are still missing. There are two things you can do to help. First you should report your hardware in [[manually indexed devices|this page]] where we gather all hardware which doesn't have a suitable category yet. Then you should ask us to make a new category for your device in our [a]http://www.h-node.org/issues/viewall/en/1/3e7831986da92994b85052adbab22ce7|Issues[/a] page.[/p]

[h3]How [h1]How can I suggest new features to be implemented?[/h3] implemented?[/h1]

[p]H-node is constantly developing. If you feel there is some feature we should add or some thing we should do differently, just make a new issue in our [a]http://www.h-node.org/issues/viewall/en/1/3e7831986da92994b85052adbab22ce7|Issues[/a] page. [/p]

[h3]I [h1]I think I have found a bug. What now?[/h3] now?[/h1]

[p]Every bug report is highly appreciated. Go to our Issues page and make a new issue. Describe the bug carefully so that we can reproduce it and fix it. You can also suggest a suitable fix for the bug yourself.[/p]

[h3]Is [h1]Is there a mailing list I can join?[/h3] join?[/h1]

[p]We have a private mailing list [[mailing lists|here]] where everyone is welcome to join.[/p]
The contents of this page are in the Public Domain. (see the CC0 page for detailed information). Anyone is free to copy, modify, publish, use, sell, or distribute the text for any purpose, commercial or non-commercial, and by any means.
h-node.org is a hardware database project. It runs the h-source PHP software, commit cdeda15, available under the GNU General Public (GPLv3) License.
JavaScript license information