search

nfc-tools / nfc-tools.github.io

nfc-tools' web site
http://nfc-tools.github.io
15 stars 13 forks source link

Migrate content #2

Open smortex opened 9 years ago

smortex commented 9 years ago

The nfc-tools wiki has a number of informational pages that are not that easy to find with the current flat layout and would benefit from a move to Jekyll with a hierarchical organization.

Open questions:

doegox commented 9 years ago

Hi Romain Documentation: sounds fine to me, or "Resources"? Initiators/targets: I'm not fan of that. initiator/target is just a role any NFC device can hold. => NFC devices and Tags? BTW "NFC tags (type1/2/3/4/5)" are missing in your hierarchy. Sth like this?

knowing that some RFID tags can be NFC tags if properly formatted...

separating standards is ok for me because they are somehow orthogonal and deserve their own page.

If you're familiar with github markdown/jekyll, go ahead, I can fix technical details later if needed.

Thanks!

Phil

smortex commented 9 years ago

:+1: for Resources (when I read Documentation I think I will find the software documentation while here we have general information about NFC).

I am updating my code to have devices and tags as you suggest. I only have difficulties to see how to split the content for RFID Tags and NFC Tags. The wiki currently redirects from NFC Tag Type 3 to FeliCa for example, and I guess you have a plan to split the information a better way.

I'll finish cleaning up the structure, commit and check that Github's version of Jekyll is fine with it, so that you can adjust all this :-)

doegox commented 9 years ago

RFID tags <> NFC tags: They are referring to different things. RFID tags = products implementing "old" standards/proprietary_standards such as FeliCa (japanese standard), ISO14443-4, Mifare Classic, Mifare Ultralight, Jewel,... NFC tags = products implementing the 4 (soon 5) NFC tag types. Usually a NFC tag is a RFID tag properly configured/formatted to accept a NDEF content. And under this scheme, usually only a subset of the original RFID tag features is used, the rest is ignored (e.g. FeliCa crypto or DesFire features).

Today there is more or less a 1-to-1 mapping between NFC tag and RFID tag (modulo the proper formatting of the tag) but tomorrow you could have several products implementing the same NFC tag "API". First one will be probably the tag type 4, if not yet the case, and you could have easily a non-NXP ISO14443-4B as basis for a NFC tag type 4.

What's a bit borderline is the configuration/formatting of a NFC tag because only the usage of a formatted tag is explained in NFC docs, not how to achieve such formatting, so where to put that info? in NFC tags or in RFID tags? ;-)

smortex commented 9 years ago

What's a bit borderline is the configuration/formatting of a NFC tag because only the usage of a formatted tag is explained in NFC docs, not how to achieve such formatting, so where to put that info? in NFC tags or in RFID tags? ;-)

What about telling that Tag X can be formatted as a NFC Forum type N tag on the Tag X page, that Tag X, Y and Z can be formatted as NFC Forum type N tags on the Type N page, and link to an example in the libfreefare for how to do this (the datasheets are supposed to already explain how to do this and we should have links to them from the RFID tag pages… this should be the primary source of information for developpers who want to use libnfc and not libfreefare)?

doegox commented 9 years ago

fine with me :)

smortex commented 9 years ago

I finally pushed a first draft: http://nfc-tools.github.io/

doegox commented 9 years ago

Great! Resources -> we land on a page with a big "Documentation" title :) logo should be more contrasted, I'll send you an update