https://pantsbuild.org/ logo
Powered by
#general
  • h

    happy-kitchen-89482

    08/07/2015, 5:32 PM
    Maybe in the future
  • h

    happy-kitchen-89482

    08/07/2015, 5:32 PM
    But apparently they can at least point us to some templates they used for docbird (whatever that is) that we might be able to reuse? So if someone at Twitter could dig into that, that would be great.
  • r

    rough-minister-58256

    08/07/2015, 5:36 PM
    😞 😞 😞
  • r

    rough-minister-58256

    08/07/2015, 5:36 PM
    docbird is sphinx-based. Simeon (who owns docbird) mentioned that we could probably just pipe our docs into pandoc to get them into sphinx format for easy generation
  • h

    happy-kitchen-89482

    08/07/2015, 5:37 PM
    We used to have sphinx docs, I can't remember why we don't any more.
  • h

    happy-kitchen-89482

    08/07/2015, 5:37 PM
    But I'd be OK with going back to that.
  • h

    happy-kitchen-89482

    08/07/2015, 5:39 PM
  • h

    happy-kitchen-89482

    08/07/2015, 5:47 PM
    Maybe we should just write the docs to sphinx from scratch, using the existing docs as guidance, rather than attempting to port them?
  • e

    enough-analyst-54434

    08/07/2015, 5:47 PM
    So, I think its worth a modicum of research into old RBs since this will be reversing a past set of changes
  • e

    enough-analyst-54434

    08/07/2015, 5:47 PM
    .rst -> .md RBs already happened once for the doc files
  • h

    happy-kitchen-89482

    08/07/2015, 5:48 PM
    I'm super-confused about all the different suffixes and formats, TBH...
  • h

    happy-kitchen-89482

    08/07/2015, 5:48 PM
    I just suspect that a lot of that verbiage is out of date anyway?
  • r

    rough-minister-58256

    08/07/2015, 5:48 PM
    rst = restructuredText, md = markdown
  • e

    enough-analyst-54434

    08/07/2015, 5:49 PM
    I think Benjy refers to the mix
  • r

    rough-minister-58256

    08/07/2015, 5:49 PM
    ah
  • e

    enough-analyst-54434

    08/07/2015, 5:49 PM
    There was some reason Larry went through all that effort
  • r

    rough-minister-58256

    08/07/2015, 5:49 PM
    haha
  • h

    happy-kitchen-89482

    08/07/2015, 5:49 PM
    yes, but I don't remember what it was
  • e

    enough-analyst-54434

    08/07/2015, 5:49 PM
    It would be good to re-grok that reason before full reversal
  • h

    happy-kitchen-89482

    08/07/2015, 5:49 PM
    Indeed
  • h

    happy-kitchen-89482

    08/07/2015, 5:50 PM
    In a world where we had no docs at all and had to start from scratch, would we want .md or .rst?
  • h

    happy-kitchen-89482

    08/07/2015, 5:50 PM
    I don't know what the cool kids do these days
  • e

    enough-analyst-54434

    08/07/2015, 5:50 PM
    OK - hand waves, .rst and the problem was
  • e

    enough-analyst-54434

    08/07/2015, 5:50 PM
    ... snippets
  • e

    enough-analyst-54434

    08/07/2015, 5:50 PM
    I think
  • e

    enough-analyst-54434

    08/07/2015, 5:50 PM
    Clearly there was more though
  • h

    happy-kitchen-89482

    08/07/2015, 5:51 PM
    well, I can volunteer to rewrite the code that generates docs from options
  • h

    happy-kitchen-89482

    08/07/2015, 5:51 PM
    I'm already maintaining it, because of all the options changes
  • h

    happy-kitchen-89482

    08/07/2015, 5:51 PM
    it's a bit spaghetti-ish, so I might as well re-do it
  • r

    rough-minister-58256

    08/07/2015, 5:52 PM
    I think the cool kids use readthedocs, which seems to support both rst and md
1...149150151...2420Latest