langchain/docs/extras/modules/agents/toolkits
os1ma 2667ddc686
Fix make docs_build and related scripts (#7276)
**Description: a description of the change**

Fixed `make docs_build` and related scripts which caused errors. There
are several changes.

First, I made the build of the documentation and the API Reference into
two separate commands. This is because it takes less time to build. The
commands for documents are `make docs_build`, `make docs_clean`, and
`make docs_linkcheck`. The commands for API Reference are `make
api_docs_build`, `api_docs_clean`, and `api_docs_linkcheck`.

It looked like `docs/.local_build.sh` could be used to build the
documentation, so I used that. Since `.local_build.sh` was also building
API Rerefence internally, I removed that process. `.local_build.sh` also
added some Bash options to stop in error or so. Futher more added `cd
"${SCRIPT_DIR}"` at the beginning so that the script will work no matter
which directory it is executed in.

`docs/api_reference/api_reference.rst` is removed, because which is
generated by `docs/api_reference/create_api_rst.py`, and added it to
.gitignore.

Finally, the description of CONTRIBUTING.md was modified.

**Issue: the issue # it fixes (if applicable)**

https://github.com/hwchase17/langchain/issues/6413

**Dependencies: any dependencies required for this change**

`nbdoc` was missing in group docs so it was added. I installed it with
the `poetry add --group docs nbdoc` command. I am concerned if any
modifications are needed to poetry.lock. I would greatly appreciate it
if you could pay close attention to this file during the review.

**Tag maintainer**
- General / Misc / if you don't know who to tag: @baskaryan

If this PR needs any additional changes, I'll be happy to make them!

---------

Co-authored-by: Bagatur <baskaryan@gmail.com>
2023-07-11 22:05:14 -04:00
..
azure_cognitive_services.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
csv.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
document_comparison_toolkit.ipynb Fix make docs_build and related scripts (#7276) 2023-07-11 22:05:14 -04:00
gmail.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
jira.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
json.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
office365.ipynb Fix make docs_build and related scripts (#7276) 2023-07-11 22:05:14 -04:00
openapi_nla.ipynb docs/fix links (#6498) 2023-06-20 14:06:50 -07:00
openapi.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
pandas.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
playwright.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
powerbi.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
python.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
spark_sql.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
spark.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00
sql_database.ipynb Fix sql_database.ipynb link (#6525) 2023-07-06 13:07:37 -04:00
vectorstore.ipynb Doc refactor (#6300) 2023-06-16 11:52:56 -07:00