Documentation

[polortiz4]

Not sure if these should be done

[epvienneau]

Yes this should be done

[epvienneau]

Cannot figure this one out...

[suyashkumar]

Ah...so this is because tensorflow is installed only inside the Docker container but the docs are being built outside the Docker container. One way to fix this is to install tensorflow globally on the machine where you are building docs pip install tensorflow.

Another solution would be to have the make html run inside the Docker container by exec'ing in...but no worries on that front, installing tensorflow on the machine to build docs should be fine.

[suyashkumar]

you could also try to run the docs process inside the docker container by doing the following, but it's definitely a little more work...

docker ps to find the server container id then docker exec -it <server container id> bash (now you're inside the container where tensorflow is available) assuming you've installed sphinx already (pip install Sphinx) you should be able to just run all the needed commands...

[epvienneau]

Thanks Suyash! Pablo somehow got this working. even pulling down his Pablo/Sphinx branch and following his same steps, it still doesn't work for me, so I'm going to let him handle this one.

[polortiz4]

@mlp6 @suyashkumar .. From the Sphinx guidelines, we're supposed to gitignore any _build/ directory, but... If so, how can you see the documentation?

[mlp6]

End user would build it in the format they want with the Makefile!

[polortiz4]

But that means they would need to have all the dependencies installed, right?

[polortiz4]

And with Emelina we noticed that’s a little more complicated than activating the environment

[polortiz4]

@epvienneau

[epvienneau]

Yea I was unable to generate the docs for myself actually :(