Minimum upgrade of the builds docs

[humitos]

• Removed a code example section that does not reflects what exactly happens anymore
• Replace the mention to options from the Admin UI for the config V2 file
• More specific on the limits

[ericholscher]

Good updates. I think it's useful to explain to the user more how builds work though, not just delete that information.

[ericholscher]

I wonder if we should still include some updated version of this. I think it's useful for users to get a mental model of what's happening.

[humitos]

I thought about this, but I came up that it was more complicated to explain in code now considering that we have many options on our config file. In the end, I seemed to me to be more confusing than clarifying.

What about this? I tried to keep some consistency with YAML options.

    update_docs_from_vcs(version)
    config = get_config(project)
    if config.python.install.method.setuptools:
        run('python setup.py install')
    if config.python.install.method.pip:
        run('pip install .')
    if config.python.install.requirement:
        run('pip install -r %s' % config.python.install.requirement)
    build_docs(version=version)
    copy_files(artifact_dir)

It's not 100% accurate, but maybe it's better than removing it. What do you think?

[ericholscher]

Looks good to me. 👍