Standardisation, specification and documentation as a starting point
for software creation is a normal, reliable and mandated (formally)
methodology used everywhere from business to scientific, industrial,
medical and military applications.  It is not only normal but expected
and even required that amateur free and open software follow the same
processes and procedures as professional modelling and implementation,
especially on historically significant long term projects that are
also programming languages and interpreters.

It's not a surprise to you, everything in UNIX is a compiler
construction reuse tooling and a small (and large) domain specific
languages.  That is the essence of the system.  OpenBSD is a
descendant of UNIX, not a free walk in the green pastures of
experimental shareware.  Now, let's get back to more productive time
and space utilisation, kids, good ideas.. third party re-imports are
waiting their normalisation and stabilisation to robust and reliable
distillations of core "base and extended" system modular componentry.
Re-read the long version of the previous post after some specialised
references again, and you will see and understand what I outlined
clearly.

https://en.wikipedia.org/wiki/Software_crisis?useskin=vector#mw-content-text
https://en.wikipedia.org/wiki/Component-based_software_engineering?useskin=vector#History
https://en.wikipedia.org/wiki/List_of_software_development_philosophies?useskin=vector#Rules_of_thumb,_laws,_guidelines_and_principles

Thanks for the discussion and support, I've said my points and think
we're in accord and agreement on all details referenced.

On 9/25/23, Rudolf Leitgeb <[email protected]> wrote:
> If you document a switch, you are basically required to keep that
> functionality around forever. Given that the OpenBSD devs don't like
> these --options all that much, I don't see that happening. Submitting
> a patch won't change that.
>
> IMHO there's nothing wrong, if software can do more than its
> documentation shows. It's not like it breaks documented behavior.
>
> On Mon, 2023-09-25 at 20:58 +0200, Marc Espie wrote:
>> Don't rant that long.
>>
>> Sometimes, documentation and code get out-of-synch for a lot of
>> reasons.
>>
>> - trying out stuff and documenting later.
>> - plain forgetting to update the documentation.
>> - having some stuff for a transition period, and then killing it.
>>
>> Your point that stuff that stays around, should ideally be
>> documented,
>> is a good point.
>>
>> Now, you gotta realize that people have limited time to do
>> everything.
>>
>> In general, patches are welcome.
>>
>> In my long tenure on various tools, I've learnt that documenting
>> stuff is always always a good idea: if you get a new feature BUT
>> you can't explain it cleanly, then you should go back to the
>> drawing-board !

Reply via email to