Skip to content

MathJax Web Presence Re organization

Jump to bottom
pkra edited this page Aug 3, 2012 · 1 revision

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 :()

MathJax Wiki

Clone this wiki locally