Publish docs

[cjihrig]

The build-and-deploy docs job currently fails because of branch protection + the CLA requirement:

remote: error: GH006: Protected branch update failed for refs/heads/gh-pages.        
remote: 
remote: - Required status check "EasyCLA" is expected.        

Can this be fixed by changing the branch protection rules on the gh-pages branch?

I'm open to other options as well.

[mstruebing]

I'm not sure if we are allowed to remove the easy CLA requirement.
@brendandburns do you know if we can remove it for this one branch?

Another option I could think of would be to use a personal token for that but that's also not a really nice solution either.

[cjihrig]

I think a worst case solution would be to have a person manually update the docs.

[brendandburns]

We have in the past gotten bot permissions to auto-approve easy-cla.

We should definitely not use personal tokens, but an interim step would be to run this in a personal fork and then send a PR.

Honestly, I don't think that the docs are super useful, so we should also consider just removing them.

[cjihrig]

Honestly, I don't think that the docs are super useful, so we should also consider just removing them.

I think two things are true. I think the docs are not very good (like most auto-generated docs). I also think the docs are useful for viewing the types and function signatures outside of my IDE.

I tried to create a PR, but GitHub says the git history for the gh-pages branch is too different. I think at a minimum we could force push the branch and then likely leave the docs alone until the next time the code generator is updated.