Design meeting minutes 7/June/2021

[Michael McMahon]

- Updated repo with lastest doxygen branch.  Link: https://jsr.manufacturaindependente.org/
- New wrappers section on the left.
- The last link to go to the source does not work yet.
- Focusing on content and layout right now.
- Fighting with the doxygen templating system.  So far so good.
- Ran into one issue.
- Pretty much working at this point.
- Are other sections necessary?
- Otherwise, we will edit the content and style like we discussed.
- After that, we will move to translations.
- Does this match expectations? Very good and nicely structured.  The design needs some work, but the main idea is there.
- Adding demo pages for each wrapper or testing pages would be a nice addition.
- doxygen pages include member definitions and other technical bits.  We took those out.  Is that good?  What we have now is something aimed at the users.  This is probably the best way to show that.  Maybe an advanced version of the API description could be aimed at developers.  The source code link could solve this potentially that includes all section comments.  Thinking about how we could have two pages for each file.  We will explore how feasible that would be.  We do not want to overwhelm the users.
- How important are diagrams?  Libor uses them from time to time to explore which functions are related.  They are handy, but probably not completely necessary.  If you manage to generate and integrate the diagrams, Libor is for keeping it.
- "Advanced" section for wrappers
- Identity issue blocker
  - What is the name?  It would be nice to reach a decision soon so that we are not developing identity concepts during crunch time.
  - June 25th deadline for a name.
  - Hermit crab character concept wearing different shells.
  - Talked about dropping the word JS from the name as most users do not know what languages are being run in their browser.  Also the project is not limited to _javascript_.
  - Hermetic -- A way to keep your browsing "sterile", free from contamination. This angle brings up nostalgia for a time when we didn't have to watch our steps while following URLs. There's also a bit of a pun with the character of the hermit crab.
  - Off-track -- About turning trackers off, and about going out of the pathway that they've laid out for you.
  - Hideout -- A place to find a bit of comfort while evil things are out there
  - Pillbug -- Another animal whose body has explicit protection mechanisms, with a reference to the venerable "Firebug" extension.
  - Protect me -- A general privacy concept.
  - Misdirection -- Adding a magician concept to highlight misdirecting snooping attempts.
  - Check through mailing list history for more names.
- Network boundary page seems to be missing.  Not a wrapper or connected to _javascript_.  Maybe wrappers could be renamed as modules or some other term.
- If there is a page that should be there and is absent, let us know.  Ideally, everything should be in the sidebar.
- All of the wrappers are described without structure.  Maybe something useful for a developer or someone who knows what beacon API or device wrapper is, but maybe for users we could generalize with ideas of threats that the user is protected from.  Right now we have levels.  Every wrapper needs to be set in levels, but from a practical view that might not be the right thing to do.  Maybe when sending a message on this topic, Libor will note about how the levels relates to the wrapper section.
- The README page is now not the same as the index page.  They are similar now, but it can be separate.
- Style editing is next.

More discussion will follow on the mailing list.

Best,
Michael McMahon | Web Developer, Free Software Foundation
GPG Key: 4337 2794 C8AD D5CA 8FCF  FA6C D037 59DA B600 E3C0
https://fsf.org | https://gnu.org