Tom Smyth Loves BSD Networking

200 Followers
125 Following
1.5K Posts
IP Network and Security Engineer, ISP Operator, Trying to be an Entrepreneur, I appreciate attention to detail. Interested in Security, Stability and BSD.
basically I spend my days / nights identifying bottle necks on networks and trying to remove them ... it is an iterative process ... but one that is rewarding for me and my users / clients
#nsh on #OpenBSD feeback wanted
likes and dislikes and Ill include the feedback in my talk and training course for nsh thanks folks
@ogmaconnect I owned the V8 and it was also amazing. Have you discovered https://www.ross-tech.com/vag-com/ ? Saved me buckets of money on figuring out what the car needed now and then.
Ross-Tech: VCDS

@stsp @kurtm Thanks for your work and patience with me ... on this ... It is a real pleasure working with you on this... and I appreciate Stefan the way you jumped into the code...and Kurt I really appreciate the introduction (patient) and advice on porting over the years... Thanks again folks :)
@mwl infrastructure is best when it’s boring and stable.
@florian I liked your website btw ..
and I liked your comment "Since we are not living in the future yet" but I was reading it in the future (compared to when you wrote it anyway) ... :)
https://web.archive.org/web/20210507122743/https://undeadly.org/cgi?action=article&sid=20131025090233
b2k13 hackathon report: Florian Obser (florian@) on nginx.conf(5), slowcgi

@florian well it can be tough mandoc to write but the results are worth it for manuals... :) and the great thing about mandoc and markdown is neither require sound to be enabled :P

@florian
I find markdown easier to write... but I do really like the results from mandoc on the console...

so I get that you recommend mandoc for manuals and something else for more web based documentation ...

@solene Having a look now thanks :)

Hey @solene How are you ?
thanks for getting back to me ..

I wanted to have a tutorial / introduction that could be read on the console as well as on a website...
I was using man -T markdown nsh.8 > nsh.manual.md and man -T html nsh.8 > nsh.manual.html and I was quite pleased with the results...

i was wondering would moving beyond a manual to a training / tutorial guide be frowned up on or had others done something similar (so I could learn from their formatting of their tutorial / training man page )

Follks do any of you use mandoc files to create tutorial pages... ? or do you generally stick to FAQs on HTML / Markdown ? ...
tips tricks or example manual files that have been used / abused to make introduction / quick start documentation ...
#OpenBSD #NSH