#readthedocs

nedbat: we don't do a great job explaining it, the default settting just points to 'latest'

agj: but there's the build named "default" and the build that has "default" checked on it.

nedbat: latest is an alias that works across all VCS types and can point at different things

its basically the thing we need to build in order to build something for everyone on first import

and it defaults to the VCS "default" branch

its generally also the version we always expect to exist on any repo as well

ericholscher: I have four active versions: https://readthedocs.org/projects/coverage/versi...

and the default version we redirect / to

ericholscher: I entered "coverage-3.7.1" in the "default version" setting on the advanced settings page, but it doesn't seem to affect what is marked as default on the versions page.

though it does change what is shown at /

yea, those are different settings -- there is a "latest" version setting too

the UI around it is a little bit confusing :)

we're working on fixing it

(eg. with that fancy new versions page)

nedbat: https://www.dropbox.com/s/f1q6jei87ru94a3/Scree... on the advanced settings page

ericholscher: I think i know enough to make it work for my needs.

nedbat: if your version names weren't prefixed, they would auto-update a stable branch that you could default to, and it would mostly just work

guessing distlib can't parse the tag string, so we don't create them

I see.

I thought about removing the prefix, to get it out of the URL also

ericholscher: and stable knows not to take 4.0a4 as stable, because it's alpha?

hmm, perhaps not

iirc there's a bug about that

:(

we need to upgrade to whatever the new version lib is in python, and iirc that will fix it

anyne from rtd that can answer my question from a couple of days back?

fgs: which was?

sorry, don't have that much scrollback

fgs: also, feel free to file a GH issue for that kind of stuff so it doesn't get lost -- IRC has a way of disappearing

ericholscher: some rst files are generated as part of the build project

IIUC there is no way to push the files so I need to point it to another repo/branch where the generated files are available.

That could work for the time being but the reference to the repo/branch will be off

sounds like you want a git submodule

So my 3 Q's: 1. is there any ETA to be able to push things? 2. Is there any alternative? 3. Is there any way to change the references to github so it's pulled from one place but shows the right branch?

but generaly, not really

i'd be curious what the use case for this is

what are the generated files?

rst files and images included in those rst files

1: "soon" :) 2: git submodule is probably the sanest answer 3: no

T_T

Is there any way to help so that "soon" becomes "sooner"? :)

if you contribute it

otherwise its on our list, but not a big priority

ok

not much time on my hands but I will see what I can do