|
Jeremy Falcon wrote: Depends on your environment Strictly C#.
/ravi
|
|
|
|
|
You could always write one in this.
Ducks and runs.
Jeremy Falcon
|
|
|
|
|
You just had to bring that guy back up...
|
|
|
|
|
Jeremy Falcon
|
|
|
|
|
Cue Vincent Price's soliloquy in Michael Jackson's Thriller:
"Darkness falls across the land,
the midnight hour is close at hand.
Creatures crawl in search of blood
to terrorize y'all's neighborhood."
Software Zen: delete this;
|
|
|
|
|
oooooh!
that is a thing of beauty
|
|
|
|
|
|
Thanks, Rick. I also think I'm going to continue to stick with SHFB as it's actively supported.
/ravi
|
|
|
|
|
Last year I posted an SHFB issue and Eric Woodruff (not family of "our" Woodruff) responded quickly.
By then I had solved the issue by arranging the project in another way, but found his response very positive.
|
|
|
|
|
Yes, EW is a good guy.
/ravi
|
|
|
|
|
Sandcastle? Is that the system I remember from the days I was maintaining a toolbox installation wizard: The users wanted Sandbox included in a toolbox. It took ages to install the 115,000 files. It turned out that those asking for it only needed the core functionality, so the installation was reduced to no more than 60,000 files.
I may be mixing it up with another tool in the same toolbox, but I believe it was Sandbox going completely bananas in number of files installed.
|
|
|
|
|
|
|
In light of your post above...
So he doesn't have to write the non-existent references that ChatGPT will create?
Software rusts. Simon Stephenson, ca 1994. So does this signature. me, 2012
|
|
|
|
|
I would say Swagger/Swashbuckle for OpenAPI-style REST API's. You can add quite some additional info on top of an already developer-oriented API description, and it can be used to generate clients that will 'just work' based on the spec.
For an SDK in the form of a nuget file, since you said you were doing C#, package a markdown readme file in the nuget, this way the documentation comes with the library. I prefer having version-bound and 'incorporated' documentation rather than having to go look for it on some site, that 9 out of 10 times is not updated to match your version.
And eventually, depending on your requirements, a generated and organic documentation site using something like docfx might be useful to give some additional info, which again, can/should be linked to from within the nuget or Swagger.
|
|
|
|
|
Ill just recap what another said, and might not be useful as sounds like a program API, instead of web API.
but yeah, OpenAPI Specification, formally Swagger, with Swashbuckle being the C# .net implementation, is a JSON formatted specification. Which has been levelled up to standard that other web api ingesting services have incorporated so no some automated level of point and click, and your program knows how all the details needed to use that web api service.
Mention only, that maybe specification been branched out to cover other types of API
|
|
|
|
|
I have always used HelpSmith for all of documentation.
It can produce CHM files along with printed output, online\HTML output, PDFs and Word documents.
See... https://www.helpsmith.com/
Steve Naidamast
Sr. Software Engineer
Black Falcon Software, Inc.
blackfalconsoftware@outlook.com
|
|
|
|
|
I had a requirement to produce documentation for a graduate class in Advanced Data Structures. The professor let us choose the language WA wanted to use, within reason. I choose C# and documented all the classes, methods, etc. using C#'s triple slash (///) syntax. I then used DocFX to produce the first pass at the doc web site. Spent some time understanding how to add additional content and spruce up the final product. Did all three projects with this technique. Was very satisfied with the result. Got a great grade, maybe because my programs were good, but I like to think the quality of the documentation site helped.
|
|
|
|
|
Getting your first Big Job at BigCorp was like this...
Here's what it looked like[^].
or at the official site:
1995-08-01 Dilbert strip[^]
That freshness didn't last long.
I remember the 3rd day I walked into work and said, "good morning" and for the 3rd time the crufty old white-beard developer said, "What's so good about it?!"
Since that fateful 3rd day, sometime in 1991, I only say, "Morning."
|
|
|
|
|
Quote: Remember being that bright, new, fresh employee? Yeah, over 37 years ago... now I am the "crufty old white-beard".
BTW - I'm surprised anyone is referencing Dilbert after Scott Adams "exploded" this weekend.
|
|
|
|
|
Oh, didn't hear about it.
How did he explode?
Also, are his comic strips any less funny regardless of his explosion?
|
|
|
|
|
raddevus wrote: How did he explode? It's described as a racist rant during a podcast. I didn't hear it and only read a few quotes out of context. So... no comment. It certainly wasn't smart.
raddevus wrote: Also, are his comic strips any less funny regardless of his explosion? That was a valid question a few years ago, but current woke culture says he and everything he's ever said or done are now racist and must be removed from the face of the Earth.
|
|
|
|
|
fgs1963 wrote: That was a valid question a few years ago, but current woke culture says he and everything he's ever said or done are now racist and must be removed from the face of the Earth.
Friggin' snowflakes. Apart from inciting a riot or slander, Adams should be able to say whatever he wants, First Amendment. The wokes don't HAVE to listen.
I’ve given up trying to be calm. However, I am open to feeling slightly less agitated.
|
|
|
|
|
MarkTJohnson wrote: The wokes don't HAVE to listen. They don't ever listen. They just trawl the world for things that they can be offended by, so they can attack someone. And the sheeple follow like the morons they are.
|
|
|
|
|
MarkTJohnson wrote: Adams should be able to say whatever he wants, First Amendment.
That is what a public face means. Rant to your wife and kids if you want where they can't react. But in the public others are allowed to react to what you said. Only place that isn't true is when a dictator speaks.
And that is what free market means. The market is free to react.
|
|
|
|