Skip to content

Commit

Permalink
Docs: small edits (#199)
Browse files Browse the repository at this point in the history
* Docs: small edits

- make the H1 nicer
- remove compatibility since it's useless information at this point
- mention that the common case is because of Read the Docs default URL pattern

* Update docs/index.rst

Co-authored-by: Eric Holscher <25510+ericholscher@users.noreply.github.com>

Co-authored-by: Eric Holscher <25510+ericholscher@users.noreply.github.com>
  • Loading branch information
humitos and ericholscher authored Jul 11, 2022
1 parent 9a94aac commit 6ca51fc
Show file tree
Hide file tree
Showing 3 changed files with 6 additions and 11 deletions.
4 changes: 3 additions & 1 deletion docs/configuration.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
Configuration
=============

The default settings generate the most commonly-used URL pattern: if you have a resource at ``_static/js/logic.js`` and you generate a 404 page with the default settings, the URL for that resource will be ``/en/latest/_static/js/logic.js``.
The default settings generate the most commonly-used URL pattern on `Read the Docs <https://readthedocs.org>`_:
if you have a resource at ``_static/js/logic.js`` and you generate a 404 page with the default settings,
the URL for that resource will be ``/en/latest/_static/js/logic.js``.

For other use cases, you can customize these configuration options in your ``conf.py`` file:

Expand Down
4 changes: 2 additions & 2 deletions docs/index.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
sphinx-notfound-page - Automatically generate Not Found (404) pages
===================================================================
Generate 404 Not Found Pages Automatically for Sphinx Docs
==========================================================

``sphinx-notfound-page`` is a Sphinx_ extension to create custom 404 pages and help you to generate proper resource links (js, css, images, etc) to render the page properly.

Expand Down
9 changes: 1 addition & 8 deletions docs/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Install the package

.. prompt:: bash

pip install git+https://github.com/readthedocs/sphinx-notfound-page@master
pip install git+https://github.com/readthedocs/sphinx-notfound-page


Once we have the package installed,
Expand Down Expand Up @@ -47,10 +47,3 @@ you can build your documentation again and you will see a new file called ``404.
If you can't see the 404.html file using a local simple web server, it is
most likely because they often don't support requests for 404 codes. Refer to
the :doc:`faq` for more information.

.. note::

This extension requires,

* Python 2.7+ or 3.x
* Sphinx 1.5+ or 2.x

0 comments on commit 6ca51fc

Please sign in to comment.