I think that, at the moment, h-node is not clear enough on how one can find out what hardware he has and how to compare them to the data on the database. This is a bit inconvenient to new users. I remember having to really search for that function when I tried to contribute my hardware to the database for the first time. The front page's button "Discover your hardware" didn't do what I expected it to do. Rather than letting me find out what kind of hardware I had and which of them where on the databe and which were not, it showed me how to use lspci command.
I suggest that we do two things to improve this matter. We change how the button works and tweak the search page a bit. The button should take the user to the search page. The Search page should have a small instruction section at the top and we could rearrange the Search page to look like this:
_______________________ home >> Search form _______________________
This is h-node's Search page. Here you can discover your hardware and check wether they can be found from the h-node's database or not. You can add missing hardware to h-node's database easily after that. You can also seach one partical piece of hardware from the database by name or by its vendorid:productid.Discover your hardware:analyze the output of the lspci command
Paste the output of the lspci -vmmnn command [ lspci -vmmnn ] to the window on the left. You will be presented a list [ ] of your hardware. From that list you can easily see [ ] which pieces of our hardware are missing from h-node [ ] and should be added. [ ] [Search]Search for one device from the database:search by model name
Select hardware category and use one or more keywords to search devices from that category. hardware type: [notebook * ] model name contains: [ ] [Search]search by vendorid:productid
You can use lspci -nnk command to find out the vendorid:productid of your hardware. Please see specific instructions here (a link to the wiki). You can then use that to do more accurate search for that device. VendorID:ProductID code of the device: [ ] [Search]
Here the search with lspci -vmmnn would be the first one because it is the most important one and most frequently used. The other two searches are categorized as their own section below. All searches contain small instructions about how to use them.
If we do this and implement the solution for issue 127, I think we can greatly improve h-node's clarity.
What do you think?