hurl/docs
2022-12-07 08:17:08 +11:00
..
assets/img Update README. 2022-10-26 22:47:04 +02:00
manual Update 1.9.0-SNAPSHOT to 2.0.0 due to major breaking change. 2022-11-29 15:51:29 +01:00
spec Add grammar to support htmlEscape and htmlUnescape 2022-12-07 08:17:08 +11:00
tutorial Fix case url -> URL. 2022-10-31 11:50:22 +01:00
asserting-response.md Change raw string body for multiline string body. 2022-11-05 19:21:45 +01:00
capturing-response.md Fix case url -> URL. 2022-10-31 11:50:22 +01:00
entry.md Update docs for 1.8.0 2022-10-24 22:33:26 +02:00
frequently-asked-questions.md Update docs for 1.8.0 2022-10-24 22:33:26 +02:00
grammar.md Modify one line string grammar for ``xxx`to x`. 2022-12-04 21:07:12 +01:00
home.md Update README. 2022-10-26 22:47:04 +02:00
hurl-file.md fix grammar in docs 2022-09-28 18:35:02 +10:00
index.md Rename manual-page.md to manual.md 2022-09-02 15:39:24 +02:00
installation.md Update all installation docs. 2022-12-03 23:28:05 +01:00
license.md Add licence.md in docs. 2022-06-05 17:33:06 +02:00
manual.md Update docs for 1.8.0 2022-10-24 22:33:26 +02:00
README.md Rename manual-page.md to manual.md 2022-09-02 15:39:24 +02:00
request.md Change raw string body for multiline string body. 2022-11-05 19:21:45 +01:00
response.md fix grammar in docs 2022-09-28 18:35:02 +10:00
running-tests.md fix grammar in docs 2022-09-28 18:35:02 +10:00
samples.md Change raw string body for multiline string body. 2022-11-05 19:21:45 +01:00
templates.md Change raw string body for multiline string body. 2022-11-05 19:21:45 +01:00

Hurl Documentation

This directory is the canonical source for Hurl documentation. The site https://hurl.dev, powered by Jekyll, is generated from it. If you want to modify https://hurl.dev, you can make a PR in this repo.

Manual Page

The canonical source for the Hurl manual pages is at https://github.com/Orange-OpenSource/hurl/tree/master/docs/manual. The markdown files hurl.md and hurlfmt.md are used :

Dependencies:

docs/manual/hurl.md => docs/manual/hurl.1
docs/manual/hurl.md => docs/manual.md

docs/manual/hurlfmt.md => docs/manual/hurlfmt.1

READMEs

GitHub README and crates.io README are generated from the canonical docs.

Dependencies:

docs/*.md => README.md
docs/*.md => packages/hurl/README.md

Scripts

  1. generate manual
  2. generate <hurl.dev> manual
  3. generate GitHub README
  4. generate crates.io README
$ python3 bin/release/gen_manpage.py docs/manual/hurl.md > docs/manual/hurl.1
$ python3 bin/release/gen_manpage.py docs/manual/hurlfmt.md > docs/manual/hurlfmt.1
$ python3 bin/docs/build_man_md.py docs/manual/hurl.md > docs/manual.md
$ python3 bin/docs/build_readme.py github > README.md
$ python3 bin/docs/build_readme.py crates > packages/hurl/README.md