dcb107ae65
* add HTTP request how to First draft. Proof read http-requests.md Formatting Reword intro modify fetch API docs links Conclusion * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci * add http-request howto into toctree, index * implement review By @madhur-tandon Implement review and fix formatting mistake in request function docstring. * add # HTTP requests section, add fetch_kwargs to helper function Add a section in the explanation discussing HTTP Requests * add API reference * [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci * specify docs for `pyodide.http` members * address review By @marimeireles * Change code [Python] to Python Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> Co-authored-by: mariana <marianameireles@protonmail.com>
PyScript documentation
Welcome to the PyScript documentation directory, where you can find and contribute to discussions around PyScript and related topics.
Getting started
Before you start contributing to the documentation, it's worthwhile to take a look at the general contributing guidelines for the PyScript project. You can find these guidelines here Contributing Guidelines
Documentation Principles
The PyScript documentation is based on a documentation framework called Diátaxis. This framework helps to solve the problem of structure in technical documentation and identifies four modes of documentation - tutorials, how-to guides, technical reference and explanation. Each one of these modes answers to a different user need, fulfills a different purpose and requires a different approach to its creation.
The picture below gives a good visual representation of that separation of concerns:
So, please keep that in mind when contributing to the project documentation. For more information on, make sure to check their website.
Setup
The docs directory in the pyscript repository contains a
Sphinx documentation project. Sphinx is a system
that takes plaintext files containing documentation written in Markdown, along with
static files like templates and themes, to build the static end result.
Build
To learn how to build the docs, head over the CONTRIBUTING page.