[site] Add 'rake index' and 'rake multirepo:reinit'

[dshevtsov]

Purpose of this pull request

This pull request:

1. Adds rake index that runs Algolia indexing (internal use only)
2. Adds rake multirepo:reindex that removes existing sources listed in Docfile.yml and runs rake init to recreate the file tree
3. Adds exception handling to the rake multirepo: tasks when a subrepository failed to checkout

[jeff-matthews]

Seems to work as expected. The only thing that's peculiar is that the reinit task is namespaced to multirepo just like init, but there's no option to run rake reinit like there is for rake init. It's not a big deal, I'm just curious why it's set up this way.

$ rake -T
...
rake index                # Generate index for Algolia
rake init                 # Pull docs from external repositories
rake multirepo:add        # Add multirepo docs providing shell arguments "dir=<directory where to init a repo>", "repo=<SSH URL>", "branch=<branch to checkout>", "filter=<true/false>" ("true" by default)...
rake multirepo:init       # Create a file tree for devdocs website and get all required content
rake multirepo:reinit     # Reinitialize subrepositories
...

[dshevtsov]

why it's set up this way

It's done on purpose to decrease risk of mixing up rake init with rake reinit. The command is destructive and can make undesirable changes when run by mistake by a person who contributes to a subrepository.

[jeff-matthews]

Thanks for explaining!

[dshevtsov]

running tests

[ghost]

Hi @dshevtsov, thank you for your contribution!
Please, complete Contribution Survey, it will take less than a minute.
Your feedback will help us to improve contribution process.