|
|
|
Some thoughts on the MathJax presence on teh intertubez(tm).
|
|
|
|
|
|
|
|
* Where are we?
|
|
|
|
* www.mathjax.org
|
|
|
|
* github.com/mathjax
|
|
|
|
* google groups
|
|
|
|
* twitter, facebook, linkedin
|
|
|
|
|
|
|
|
* Where else could we be? What could we use?
|
|
|
|
* google+ page
|
|
|
|
* youtube/vimeo etc for video tutorials
|
|
|
|
* stackexchange/osqa for ourselves
|
|
|
|
|
|
|
|
What are we doing where?
|
|
|
|
|
|
|
|
* github
|
|
|
|
* code repository (duh!)
|
|
|
|
* development wiki (double duh!)
|
|
|
|
* issue tracker
|
|
|
|
* testing suite repository
|
|
|
|
* development tools repository
|
|
|
|
* soon: docs repository, example-apps repository
|
|
|
|
* google groups
|
|
|
|
* user group -> everything
|
|
|
|
* dev group -> MJ development related stuff
|
|
|
|
* social networks
|
|
|
|
* twitter: looking for conversations
|
|
|
|
* linkedin: MJ group for announcements
|
|
|
|
* facebook: for announcements
|
|
|
|
|
|
|
|
* www.mathjax.org
|
|
|
|
* wordpress
|
|
|
|
* blog/news
|
|
|
|
* pages about MathJax (pretty wild mix)
|
|
|
|
* sphinx docs
|
|
|
|
|
|
|
|
### current issues
|
|
|
|
|
|
|
|
* www.mathjax.org
|
|
|
|
* docs have "fake" wordpress theme.
|
|
|
|
* docs 1.1 not showing that they are outdated.
|
|
|
|
* wordpress search vs docs search -> confusion
|
|
|
|
* wordpress contains some stuff that really belongs to the documentation
|
|
|
|
* and vice versa
|
|
|
|
|
|
|
|
### who are our users?
|
|
|
|
|
|
|
|
* What types of users do we have?
|
|
|
|
* The Reader
|
|
|
|
* has seen content using MathJax
|
|
|
|
* maybe did a search, clicked on a badge, maybe a potential sponsor
|
|
|
|
* just wants to know what it is
|
|
|
|
* might become...
|
|
|
|
* The Author
|
|
|
|
* wants to author mathematical content
|
|
|
|
* might become...
|
|
|
|
* The Developer
|
|
|
|
* writes some kind of application that involves mathematical notation
|
|
|
|
* could be a web app, mobile app, desktop app
|
|
|
|
* might become...
|
|
|
|
* The Hacker
|
|
|
|
* wants to modify MathJax
|
|
|
|
* maybe just for an app, maybe write an extension, maybe a jax, maybe get fully involved
|
|
|
|
|
|
|
|
* What do these types need?
|
|
|
|
* The Reader
|
|
|
|
* needs a good landing page
|
|
|
|
* needs to know that readers don't have to do anything
|
|
|
|
* needs to be wowed with some cool demos ;)
|
|
|
|
* might want to know about helpers (FF font plugin, Mathjax-This-Page bookmarklet, greasemonkey scripts)
|
|
|
|
* might need to know about user group
|
|
|
|
* The Author
|
|
|
|
* needs to understand what authors have to do, depending on their authoring platform
|
|
|
|
* needs to understand CDN
|
|
|
|
* might need to understand installing MathJax on a server
|
|
|
|
* might need info for platforms (wordpress, blogspot, mediawiki etc)
|
|
|
|
* might need small tweaks (disqus-comments scripts)
|
|
|
|
* might need authoring help (pandoc, Qute, MathType, apps)
|
|
|
|
* needs to know about the user group
|
|
|
|
* might need to know about issue tracker
|
|
|
|
* might want to add/modify our documentation
|
|
|
|
* The Developer
|
|
|
|
* needs to know about API
|
|
|
|
* needs to know about the issue tracker
|
|
|
|
* needs to know about "shrinking", which parts of MathJax are needed for which browsers
|
|
|
|
* needs to know about example apps
|
|
|
|
* needs to know about helpful snippets
|
|
|
|
* might want to add/modify our documentation
|
|
|
|
* might want to be on the dev list
|
|
|
|
* The Hacker
|
|
|
|
* needs to know about testing suite, development tools, development wiki
|
|
|
|
|
|
|
|
|
|
|
|
### Re-organizing our web presence
|
|
|
|
|
|
|
|
Some ideas.
|
|
|
|
|
|
|
|
* www.mathjax.org
|
|
|
|
* pure landing page
|
|
|
|
* i.e., only highly stable content such as info for Readers
|
|
|
|
* good navigation for everybody else (i.e. to news/blog and docs)
|
|
|
|
* blog.mathjax.org
|
|
|
|
* for what used to be www.mathjax.org/news as well as "usefully outdated" content (Neil's article on a11y, Hylke's article on LMS)
|
|
|
|
* docs.mathjax.org
|
|
|
|
* our new docs, hosted at rtfd
|
|
|
|
* structured to help Authors, Developers and Hackers find the right parts
|
|
|
|
* incorporates the documentation from www.mathjax.org (e.g. Mathjax-in-Use, epub readers, browser-compatibility)
|
|
|
|
* easier to add user contributions via "edit on github"
|
|
|
|
* clearly distinguished theme to avoid confusion with main site
|
|
|
|
|
|
|
|
* How?
|
|
|
|
* docs -> rtfd.org
|
|
|
|
* website -> github-pages/jekyll
|
|
|
|
|
|
|
|
* What would it require?
|
|
|
|
* convert our theme to jekyll (use twitter-bootstrap?)
|
|
|
|
* understand rtfd.org standard theme enough to get some "branding" going (i.e., link to www.mathjax.org & logo)
|
|
|
|
* OR design sphinx theme (needs: add manual links for versions, allows: better control, warning of old versions)
|
|
|
|
|
|
|
|
* Transition
|
|
|
|
* introduce docs.mathjax.org, blog.mathjax.org slowly & use redirects to update search engines (one caveat of github/pages: no redirects :() |
|
|
|
\ No newline at end of file |