From fd847a9669be42f72857e3da0f5012fbf32e1c76 Mon Sep 17 00:00:00 2001 From: ApsisRS contributors Date: Fri, 2 Oct 2026 00:19:37 +0800 Subject: [PATCH] docs: describe the notation at the precision it uses The comment said the inclination was rounded to one decimal place, but the format prints it at full precision, so 53.25 degrees came out intact where the comment promised 53.2. The notation is an identifier, so truncating it would lose information for nothing. --- crates/network/apsis-constellation/src/walker.rs | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/crates/network/apsis-constellation/src/walker.rs b/crates/network/apsis-constellation/src/walker.rs index 6dfcd86..0a39679 100644 --- a/crates/network/apsis-constellation/src/walker.rs +++ b/crates/network/apsis-constellation/src/walker.rs @@ -120,12 +120,15 @@ impl WalkerPattern { /// Returns the Walker notation for this pattern, such as `53: 24/3/1`. /// - /// The inclination is rounded to one decimal place, which is the - /// precision the notation is normally quoted to. + /// The inclination is printed at full precision, so a value such as + /// 53.25 degrees survives the round trip. The notation is an identifier + /// rather than a rounded quotation, so truncating it would lose + /// information for no gain. /// /// 返回该构型的 Walker 记法，例如 `53: 24/3/1`。 /// - /// 倾角保留一位小数，即该记法通常引用的精度。 + /// 倾角按全精度打印，因此 53.25 度这样的值可以原样往返。该记法用作标识而 + /// 非取整后的引用值，截断它只会丢失信息而没有收益。 pub fn notation(self) -> String { format!( "{}: {}/{}/{}",