"The section sounds slightly too passive to me. ..."


by Eric Rogstad Jun 25 2016

Summaries \- Summaries appear in popovers and are widely seen by readers who want a brief introduction, so improving them or adding them to pages which lack an appropriate one is high\-value\. Definition pages \- Formal definitions of mathematical concepts\. These provide foundations for the rest of our content and allow people familiar with the topic to quickly pick up or refresh an idea\. Examples: Explanation pages \- Single page explanations of concepts, with different lenses for people with different backgrounds\. These are best suited to mid\-sized concepts, and should aim to teach them intuitively\. Full guides \- Multi\-page flexible guides to topics are Arbital's specialty\. If you're confident in your ability to explain a complex topic, considering helping to plan and create these \(talking to the community on Slack is usually a good idea, you'll get valuable feedback and assistance on your plans\)\. External resource lenses \- When there's an excellent explanation elsewhere on the web, we'd like people browsing Arbital to be able to find it\. We welcome new lenses, with links to and brief descriptions of high\-quality external resources, for existing Arbital pages \(but not standalone resources pages, we'd like at least a stub page with a popover\-appropriate summary\)\.

The section sounds slightly too passive to me. What would you think of the following re-write?

External resource lenses - When users are reading about a topic on Arbital, we'd love to also be able to point them to high-quality external resources where they can learn more, or look at things from another angle. Generally, these links should go in an External resources lens, connected to an existing main page. (Don't create a new standalone page just for links to resources, unless there's already a main page with a good summary explanation of the concept -- we want to make sure users who hover over a greenlink to the page will see a good summary.)