ariasanovsky/spindle

user outreach goals for 0.2.x

Opened this issue · 0 comments

  • create an accessible public channel for accessibility errors
    • e.g., linker errors, docs not building, unable to run examples, "works on my machine"
    • recreating problems, sharing errors/build environment
  • create an accessible public channel for ergonomics/syntactic sugar proposals
    • e.g., "I was thinking of a macro spindle::foo!(bar, baz); that..."
    • e.g., "I want to specify ... from the terminal like this: ..."
  • expand community guidelines (goal: low-bandwidth skimmable collaboration)
    • short, quotable comments in a reply chain > multiple paragraphs with many different ideas
    • short code snippets w/ verbosity elided > rigorously implemented code snippets
    • important types explicitly mentioned > elided all types to save space
    • tl;dr summaries w/ references > links/attachments and direct copy+paste
    • copy-pasted spindle code w/ permalink > copy-pasted spindle code or permalink
    • freeform workflow diagrams > sequential blocks of code