From 85c345d9b8f9819f4cdb6d0bf77446ee712fa3e9 Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Tue, 5 Mar 2024 20:50:05 -1000 Subject: [PATCH] ;doc: small fixes --- doc/PULLREQUESTS.md | 7 ++++--- hledger/hledger.m4.md | 4 ++-- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/PULLREQUESTS.md b/doc/PULLREQUESTS.md index 4ac8dab61..ac70df188 100644 --- a/doc/PULLREQUESTS.md +++ b/doc/PULLREQUESTS.md @@ -14,15 +14,16 @@ Here are some tips for contributing PRs to hledger. We aim to improve and sustain hledger's quality and maintainability over the long term. Many PRs, especially small ones, and even some big ones, can be merged quickly. -We love merging good PRs quickly. +We love merging PRs quickly. Some bigger or more risky PRs can require substantial review, discussion, changes, or re-submission. Sometimes this is a bigger task than the coding. Much valuable design, quality control, and knowledge sharing happens at this time. -Some PRs get rejected, but their discussion and exploration can still be a useful contribution. + +Some PRs ultimately get rejected, but their discussion and exploration can still be a useful contribution. We very much want to avoid wasted work, but it occasionally happens. Our process is evolving and imperfect. -All of this is normal. +All of this is a normal part of software development. We hope you'll see it as a golden opportunity to collaborate with experts, share and receive knowledge, refine your design/documentation/code, diff --git a/hledger/hledger.m4.md b/hledger/hledger.m4.md index 559f26da3..617835716 100644 --- a/hledger/hledger.m4.md +++ b/hledger/hledger.m4.md @@ -2401,7 +2401,7 @@ these must be separated by **two or more spaces**. This helps hledger know where the period expression ends, so that descriptions can not accidentally alter their meaning, as in this example: -``` +```journal ; 2 or more spaces needed here, so the period is not understood as "every 2 months in 2023" ; || ; vv @@ -2595,7 +2595,7 @@ will cause the calculated amount to have that cost attached: 2019/1/1 (a) = $1 @ €2 ``` -``` +```cli $ hledger print --explicit 2019-01-01 (a) $1 @ €2 = $1 @ €2