|
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.
|
|
|
|
|
jschell wrote: in the public others are allowed to react to what you said
Many times, that gets overlooked. No one should be surprised at this point with public (over) reactions at this point.
"the debugger doesn't tell me anything because this code compiles just fine" - random QA comment
"Facebook is where you tell lies to your friends. Twitter is where you tell the truth to strangers." - chriselst
"I don't drink any more... then again, I don't drink any less." - Mike Mullikins uncle
|
|
|
|
|
It is the childish "We don't like what you are saying so NO ONE should be able experience ANYTHING that you have ever said or written." attitude that is the problem.
You can disagree with what someone says but extending that to preventing them from expressing themselves is censorship.
I agree with Voltaire, "I detest what you write, but I would give my life to make it possible for you to continue to write."
I also think it is better to know what the opposition is thinking.
The newspapers who dropped his strip were within their rights to do so. To say he shouldn't be able to express himself is wrong.
I’ve given up trying to be calm. However, I am open to feeling slightly less agitated.
|
|
|
|
|
fgs1963 wrote: It's described as a racist rant...
Even the word itself sounds racist.
"One man's wage rise is another man's price increase." - Harold Wilson
"Fireproof doesn't mean the fire will never come. It means when the fire comes that you will be able to withstand it." - Michael Simmons
"You can easily judge the character of a man by how he treats those who can do nothing for him." - James D. Miles
|
|
|
|
|
fgs1963 wrote: 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.
AKA Cancel Culture.
Whatever happened to free speech? And tolerance?
|
|
|
|
|
I am in the same boat, but I am unable to find a job due to age discrimination.
Ed
|
|
|
|
|
|
You lucky sod! My box wasn't even genuine cardboard!
Freedom is the freedom to say that two plus two make four. If that is granted, all else follows.
-- 6079 Smith W.
|
|
|
|
|
Daniel Pfeffer wrote: My box wasn't even genuine cardboard!
Well, mine was in the middle of an Interstate highway, so just going to the bathroom was very dangerous. 
|
|
|
|
|
|
fgs1963 wrote: Four Yorkshiremen- Monty Python - YouTube[^]
An inspiration to all braggarts and liars. 
Freedom is the freedom to say that two plus two make four. If that is granted, all else follows.
-- 6079 Smith W.
|
|
|
|
|
raddevus wrote: Since that fateful 3rd day, sometime in 1991, I only say, "Morning."
"Morning" is not so bad. I had coworkers who would show up without saying a word and just sit at their desks. Sometimes maybe they hoped we would not notice they were late but most of the time they were just plain impolite. When one of them would later come and start talking to me, I would let them finish and then go "Good Morning!" even if it was well past midday. 
Mircea
|
|
|
|
|
The other ones are obvious but why do you have to be new? New sounds like absolute beginner in the field.
|
|
|
|
|
Never, but never, interrupt a developer in deep thought.
Zero needless conversation.
|
|
|
|
|
My first job was at a real Development shop during some exciting times.
Each Developer had a private window office that looked out over a forested flood zone.
Code for 4 hours, start a compile which took about 45 minutes, go to lunch. Debug/test code another 4-5 hours, start a compile, go home.
Next job was fairly similar. Last 30 years have trended continuously worse for productivity in terms of cardboard boxes.
|
|
|
|
|
englebart wrote: forested flood zone...Code for 4 hours ...
So it never actually flooded? Because if it did presumably your day would have been different?
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
