AI for writing documentation

hruodr said:
Without understanding mdoc, those .Cm introduce text as bold face, have clearly a wanted effect in
the representation, perhaps their are though to be used in other logical context.
Click to expand...
hruodr said:
Or perhaps use older standards: mandoc -Tman txl.mdoc > txl.man
Click to expand...

My point may not have completely landed. So, this may sound like I'm patronizing you--I'm not--but stay with me a second please.

The equivalent being:
Code: 
mv /etc/rc.conf /etc/file
mv /etc/crontab /etc/file
mv /usr/local/etc/sshd...

then...
find --type f --name "file" /

A 'command modifier' is an argument to the command (sans dash) as far as I understand it. `mandoc(1)` brought the ability to search and thus why BSD now treats `mdoc(1)` as a "*semantic* markup language" (not a "formatting markup language"). The AI is doing you (and anyone that installs your manpage) a disservice by removing a portion of functionality. Meaning: if you want it bold, use bold (which means nothing in the 'semantic markup' scheme other than to make it stand out).

No please. Do not do that. The old "man" format is not guaranteed to render (as a manpage) properly but you have the right idea for my example above. If you take that 'semantic markup' and translate it to "another format" then you either get pretty colors (no 'semantics' involved) or gibberish--because now every file is called "file" for example.
 
JohnK said:
My point may not have completely landed.
Click to expand...
Of course I get your point. I am not an expert on roff, but I have a different sense of the importance of separating structure and rendering.

This is like the story of HTML and CSS. Originally HTML did not strongly distinguished between structure and rendering, later the separation became it stricter, HTML for structure, CSS for representation. I am till at the level
of HTML 1, I like simplicity.
 
drhowarddrfine said:
Thus the problem.

There is an article online that says the free AI tools are not what company programmers use. Those types pay for the AI tools they use and that means hundreds of dollars a month. Even then the generated code has to be gone over. He recommends, for you and me, buy the $20/ month AI and you'll see the difference. I intend to try it for the fun but I'm not having fun right now.
Click to expand...
Install OPENCODE. They have different Tier 1 model every month or so for FREE (some throttling is present tho). Now, I believe, it is the Big Pickle - anonymous, so probably Chinese beast of a model.
I gave it really lousy prompt, told it to set up the agents itself and to not bother me with questions. The process amazed me - it even created simulation of ethernet medium so it could test the program (sending files over UDP using one-directional gateway). Spat out complete code, documentation, how-tos, ASCII diagrams. Needs some tweaking but if I had to code it myself it would be a week at least, assuming I had miraculously learned python on professional level in my sleep.
 
You must log in or register to reply here.
Back
Top