<div dir="ltr"><div dir="ltr">On Tue, Oct 13, 2020 at 11:25 AM Grant Gainey <<a href="mailto:ggainey@redhat.com" target="_blank">ggainey@redhat.com</a>> wrote:<br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">After the discussion in yesterday's pulp-team-mtg about building docs, and in honor of docs-day, I have been looking into what it would take to make updating our docs not require a dev-environment installation.<div><br></div><div>Building docs includes building the REST API docs, which wants to talk to a running pulp-server. Sphinx also relies on django, which relies on settings, which are Unhappy if you're not on an installed pulp-instance. When all you want to do is edit the static pages, this is all overkill.</div></div></blockquote><div><br></div><div>Kudos to Mel Corr for trying to make my approach work and flushing out all the remaining assumptions around "you have pulp installed"! If anyone else wants to experiment with this, and is willing to ignore a lot of scary-looking warnings, the recipe <b>that actually works</b> can be found here:</div><div><br></div><div><a href="https://github.com/ggainey/pulp_startup/blob/main/docs_build/directions.txt" target="_blank">https://github.com/ggainey/pulp_startup/blob/main/docs_build/directions.txt<br></a></div><div><br></div><div>This is working for Mel, so I'm confident it should be 'usable' for all.</div><div><br></div><div>Note: just to reiterate, this is a gross, blecherous workaround - next steps are to come up with changes to make this kind of build a supported part of the pulp experience.</div><div><br></div><div>G</div></div>-- <br><div dir="ltr"><div dir="ltr"><div><div dir="ltr"><div>Grant Gainey</div><div>Principal Software Engineer, Red Hat System Management Engineering</div></div></div></div></div></div>