search

arduino / glossary-en

Other
9 stars 6 forks source link

Glossary per Architecture #7

Open 00alis opened 8 years ago

00alis commented 8 years ago

It would be really really helpful to have a page per architecture we use: AVR SAM SAMD ARC32 I586 I686

Listing all the boards that belong to each architecture. @simonePDA @akash73

00alis commented 8 years ago

reporting here @SimonePDA answer I got via email

I agree. I still have to learn ASCIIDOC and I am also trying to elaborate and propose a structure for the glossary terms. Currently the terms and texts of Create glossary are short (or very short) and don't contain any external link.

I was thinking about a structure that is:

Term short (quick and dirty) explanation (read more...) Simple, but technically sound explanation of the term/technology Suggested readings Some external links with references and in depth contents.

what do you think?

It sounds good to me! We are making great progress with the Reference finally and you can see the work in progress here https://cdn.arduino.cc/reference/en/#documentation In the side bar you can see the item 'Glossary', attached the mockups. Glossary.pdf

Thanks!