risp/README.md

36 lines
1.2 KiB
Markdown
Raw Normal View History

2024-02-05 11:40:28 +01:00
# Add new law text
## Tests
- Getting paragraphs from `law_id` (`risparser::overview::test::parse()`)
2024-02-05 11:40:28 +01:00
- Create file `law_id` in `./data/expected/overview` (then run tests to get current output + save in file)
2024-02-06 11:30:28 +01:00
- Create config file in `./data/configs/`
2024-02-04 12:11:34 +01:00
# Integration test
- Nice test would be to re-create html ris file and compare it (problem with custom fixes, though)
2023-11-03 14:26:18 +01:00
# Goals
2023-11-06 17:37:22 +01:00
- [x] I want to have the text of the law.
2023-11-07 08:50:04 +01:00
- [x] I want to see the structure (proper headers) of the law.
2023-11-03 14:26:18 +01:00
- [ ] I want to be able to make comments (e.g. Erschöpfung) on certain parts
- [ ] I want to see since when this paragraph is in use.
2024-02-06 11:30:28 +01:00
- [.] Lawtext should be updateable
2023-11-03 14:26:18 +01:00
2024-02-06 11:30:28 +01:00
# Mindset
2023-11-03 14:26:18 +01:00
- I don't want to restrict myself with a [parser combinators](docs.rs/nom) but code it myself using *recursive descent* parser.
- Be strict in what I process. Fail if anything unexpected happens. The user should handle this case. It's fine if one decides to ignore the new/unexpected field, but it should be done deliberately.
2024-02-06 11:30:28 +01:00
# Nomenclature
2023-11-03 22:40:19 +01:00
- Law ("Gesetz"): e.g. UHG, TEG, ABGB
- Section ("Paragraph")
- Subsection ("Absatz")
- Item ("Ziffer")
- Heading-{1,2,3,...}
2024-01-26 16:55:15 +01:00
2024-02-06 11:30:28 +01:00
# Folder-Structure of this repo
- ./data
- cache -> cache for `overview` tests
- expected
- overview -> expected xml links of law_ids