#general
- a
ancient-stone-50795
08/07/2015, 7:19 PMYes, it is. We switched away from read the docs because we wanted the ability to do more. - a
ancient-stone-50795
08/07/2015, 7:19 PM(but we haven’t to date done more) - r
rough-minister-58256
08/07/2015, 7:19 PMah - b
bored-art-40741
08/07/2015, 7:19 PMI honestly think the advocates for having our own website design and layout are significantly underestimating how much work it is, and how much is hidden behind something like RTD in terms of mobile support and general flexibility - a
ancient-stone-50795
08/07/2015, 7:20 PMI think advocates for going back to read the docs overestimate how much better it will be, and underestimate the amount of effort. - b
bored-art-40741
08/07/2015, 7:20 PMI say this having done my time for about 5 years in the frontend web dev mines - a
ancient-stone-50795
08/07/2015, 7:21 PMI do think that mobile support would be a nice side effect, but I have never once wanted to refer to the pants doc on my phone. - a
ancient-stone-50795
08/07/2015, 7:21 PMMaybe I am a luddite. - r
rough-minister-58256
08/07/2015, 7:22 PMwhat sort of change might we want to make to the docs that rtd would make not possible? - r
rough-minister-58256
08/07/2015, 7:23 PMI can’t think of a good example that the RTD layout can’t accomodate - a
astonishing-jelly-60479
08/07/2015, 7:23 PMmaybe a nicer landing page aimed at a very general audience - r
rough-minister-58256
08/07/2015, 7:24 PMlanding page should be p easy to host on github pages - b
bored-art-40741
08/07/2015, 7:24 PMThe landing page in rtd is basically arbitrary, short of having the sidebar, which I don't mind at all for navigation and discoverability - r
rough-minister-58256
08/07/2015, 7:24 PMwith clickthrus to the main doc site - b
bored-art-40741
08/07/2015, 7:24 PMOr that - a
astonishing-jelly-60479
08/07/2015, 7:27 PMon an unrelated note, how long does it take for new builds to show up on pypi? i don't see 0.0.41 yet - a
astonishing-jelly-60479
08/07/2015, 7:28 PMor maybe it's not out yet - h
happy-kitchen-89482
08/07/2015, 7:41 PMThis isn't an either-or proposition - h
happy-kitchen-89482
08/07/2015, 7:41 PMa nice landing page can point to rtd - a
ancient-stone-50795
08/07/2015, 8:10 PM@astonishing-jelly-60479: I fogot to bump the version to 0.0.41 in version.py . Looks like that build mostly worked in CI so I’ll publish now - a
ancient-stone-50795
08/07/2015, 8:17 PMOK, it’s on pypi now: https://pypi.python.org/pypi/pantsbuild.pants/0.0.41 - r
rough-minister-58256
08/07/2015, 9:29 PMinteresting re: Larry’s reply about sphinx. we seem to do precisely this (aggregating sphinx docs from disparate multiple folders in a given repo) for our internal twitter.common_internal docs. - r
rough-minister-58256
08/07/2015, 9:29 PMusing sphinx - r
rough-minister-58256
08/07/2015, 9:29 PMso it seems it can totally be done - r
rough-minister-58256
08/07/2015, 9:29 PMI asked Simeon if he’d join our cause next week - he’s apparently the guy that originally ported the pants docs from confluence -> sphinx for travis crawford prior to Larrys MD conversion - r
rough-minister-58256
08/07/2015, 9:30 PMhe said he’s in. he’s the guy that built our internal documentation site and tooling which all uses sphinx, so should be a good bit of domain expertise. - r
rough-minister-58256
08/07/2015, 9:31 PM(even if the solution isn’t to switch back to sphinx) - b
bored-art-40741
08/07/2015, 9:37 PM++ - h
happy-kitchen-89482
08/08/2015, 3:35 AMawesome - g
gorgeous-fish-11040
08/10/2015, 6:26 PMWill merge https://rbcommons.com/s/twitter/r/2579/ soonish if no one will complain. Already got a shipit from @ancient-stone-50795. /cc @happy-kitchen-89482 and @enough-analyst-54434 if interested.