Bug 265411

Comment 1 Sergio Carlavilla Delgado 2022-07-24 07:53:26 UTC

Hi,

Thanks for taking care of this.
Right now  I'm only using igor with the Manual Pages. I'm not using it for AsciiDoc.
The idea is to replace igor with aspell/hunspell for Manual Pages too or only for AsciiDoc?

Comment 2 Muhammad Moinur Rahman 2022-07-24 10:29:12 UTC

(In reply to Sergio Carlavilla Delgado from comment #1)
Hi,
Currently there is no easy way to replace igor with something else fully as it has some features which are still required by us. But using it as a spelling checker with editors doesn't look too appealing to me at this point as igor has not been updated since a long time and I am not sure whether if the author is still maintaining it or not. But I believe we can try to split the configuration into two different part where for man pages we are using igor and for asciidoc we are using aspell/hunspell.

But in case you are more eager to have a perfect system/replacement we can also try implementing and writing our vale styles which incorporates the rules of igor.

(In reply to Muhammad Moinur Rahman from comment #2)

I was coming here to suggest textproc/vale for the styleguide side of igor too. That said, I'd recommend being very careful in both implementing and explaining the style rules, as misguided stylecheckers can be very wrong and misleading to writers not alert to how English works, as demonstrated by not reliably telling passive voice from active voice.

Comment 4 Muhammad Moinur Rahman 2022-07-26 21:23:34 UTC

(In reply to Pau Amma from comment #3)
That is indeed true. But if you look at the source code of Igor it actually does the same just in a limited scale. So yes as said if anyone is up with the courage to we can collaboratively try to write our vale styles. It will take some times to come to a perfect situation to be widely used by the committers but once we can make it handy that will greatly improve the writability of more docs upto the par of FreeBSD docs.

(In reply to Muhammad Moinur Rahman from comment #4)

By "that" in "That is indeed true", do you refer to the first sentence in my previous comment? ("I was coming here to suggest textproc/vale for the styleguide side of igor too.")

Regardless, I seldom if ever look at software source code these days. There's a reason my software focus in the past 6+ years has been documentation and support, not development. So I'll take your word for it that Igor does try to explain, no matter how (in)accurate its explanations are.

Comment 6 Sergio Carlavilla Delgado 2022-10-08 10:15:31 UTC

For this. Can you please send an email to doceng?

Comment 7 Muhammad Moinur Rahman 2022-10-08 13:48:32 UTC

Closing the ticket here and moving to internal discussion with doceng@ as this is more like a feature improvement in a bigger picture which needs some careful and articulated plan.