|
Several years ago, I considered implementing Sandcastle, but I never became sufficiently motivated to make it happen. By the time I became so motivated, it was evident that the momentum was shifting in favor of DocFX. If you are serious about using it, you might want to read How To Integrate DocFX API Documentation Into Your GitHub Repository, which describes the lessons I learned during my implementation. I've been using it long enough now that it "just works."
David A. Gray
Delivering Solutions for the Ages, One Problem at a Time
Interpreting the Fundamental Principle of Tabular Reporting
|
|
|
|
|
|
For what it's worth, since DocFX generates static HTML pages, you can host them anywhere.
David A. Gray
Delivering Solutions for the Ages, One Problem at a Time
Interpreting the Fundamental Principle of Tabular Reporting
|
|
|
|
|
Found a typo:
Quote: suzh as 1 and l
What the heck is this thing anyways?
Latest Article - A 4-Stack rPI Cluster with WiFi-Ethernet Bridging
Learning to code with python is like learning to swim with those little arm floaties. It gives you undeserved confidence and will eventually drown you. - DangerBunny
Artificial intelligence is the only remedy for natural stupidity. - CDP1802
|
|
|
|
|
David updated his information, see above 
|
|
|
|
|
What happens if everybody tries to push their "product" here like this?
It does not solve my Problem, but it answers my question
modified 19-Jan-21 21:04pm.
|
|
|
|
|
I've made one announcement. Other than answering questions, that's all you'll see from me. BTW, it's also free to all comers. There's already been a minor update since I wrote the original message, which would have gone without mention, had I not wanted to reply to this message.
David A. Gray
Delivering Solutions for the Ages, One Problem at a Time
Interpreting the Fundamental Principle of Tabular Reporting
|
|
|
|
|
I think the point he was making was that this forum isn't really intended for posting announcements of software releases or package updates. Instead, have you considered writing an article, tip or blog post to highlight your software and give some background on it and it's usage?
As per the forum description at the top of the page:
The Weird and The Wonderful forum is a place to post Coding Horrors, Worst Practices, and the occasional flash of brilliance.
|
|
|
|
|
Yep. Point taken, and I've found a more appropriate forum for it.
David A. Gray
Delivering Solutions for the Ages, One Problem at a Time
Interpreting the Fundamental Principle of Tabular Reporting
|
|
|
|
|
The https://github.com/txwizard/WizardWrx_NET_API is now at version 7.15, with one subtle bug smashed flat and a few interesting, but obscure changes. As always full documentation is at https://txwizard.github.io/WizardWrx_NET_API/.
What makes this especially interesting is the way the bug that motivated this update came to the surface; it appeared in the output dumped into the Visual Studio debugger window of an application that consumed it.
Numerous distractions interfered with finishing the repair. The event that pushed me to finish it was a very minor addition that I needed to make to WizardWrx.Common.dll, one of three libraries that underpin the whole API. The common library is composed almost entirely of constants, to which I needed to add a few new ones so that I can use them as building blocks from which to build other string constants. Though all of them were already defined as character constants, you cannot mix character and string constants in the definition of a new string constant.
The WizardWrx .NET API is a set of libraries that expose a rich set of general-purpose helper classes for use in projects that target the Microsoft .NET Framework. Among other things, they offer the following.
1) Syntactic sugar, such as the routines that identify the first, last, and next-to-last iteration of a FOR loop, convert subscripts to and from ordinals (zero-based versus one-based subscripts), compute a modulus (remainder), and perform decimal shifts
2) Prse dynamically generated format control strings (used with string.format and such),
3) Reduce computing message digests to a single method call
4) Transparently convert Registry values of all types into native types (strings, integers of various sizes, and byte arrays)
5) Parse command line arguments for any program (command line or graphical),
6) Add numerous extension methods to system.string and system.IO.FileOnfo
7) Simplify working with the match groups returned by the Regular Expression engine
8) Dynamically generate format strings to compactly represent data in tabular format
9) Implement the Singleton design pattern in a way that fully leverages certain guarantees about the behavior of static constructors
10) Format and log exception reports, optionally recording them in a Windows Event Log and efficiently reporting them on the two standard console output streams, taking into account when either or both has been redirected to a file
11) Accurately identify the type of processor on which the code is executing and the Windows subsystem (character mode, graphical, etc.) in which it is executing
12) Walk the dependency tree of any executing assembly
13) Sort collections of FileInfo objects, so that the files they represent can be processed in any order
14) Provide scores of handy symbolic constants to disambiguate and properly document your code
The3re is much more; these are the highlights, most of which I use daily.
David A. Gray
Delivering Solutions for the Ages, One Problem at a Time
Interpreting the Fundamental Principle of Tabular Reporting
modified 4-May-19 3:09am.
|
|
|
|
|
Upon trying to log into one of my favorite sites this morning:
ErrorCode 9002
Message [Macromedia][SQLServer JDBC Driver][SQLServer]The transaction log for database 'irongate' is full due to 'LOG_BACKUP'.
SQLState HY000
|
|
|
|
|
 At least they gave you a descriptive, detailed error message! 
"Go forth into the source" - Neal Morse
|
|
|
|
|
I was thinking the same thing. One of the best error messages I have seen in a while, actually.
|
|
|
|
|
Reminds me of the Applebee’s Wi-Fi post I made here some time ago. Basically they had their site in debug mode on the production server. I actually got a similar issue a few weeks later, and discovered an admin debug console on that page. I sent them an anonymous email about the issue after that. I think someone got chewed out for that stupidity.
What do you get when you cross a joke with a rhetorical question?
The metaphorical solid rear-end expulsions have impacted the metaphorical motorized bladed rotating air movement mechanism.
Do questions with multiple question marks annoy you???
|
|
|
|
|
|
http://www.commitstrip.com/en/2017/01/16/nice-try/
|
|
|
|
|
Which was build by a real good programmer before my time, which allows our various business groups to connect to an external 3rd party API. So far so good...
Each of the business groups has their own profile with that the external resource; they have a GUID for a license and an alias so that it is easy to see which group any GUID is associated with. Still good...
We have developed the applications that utilize this service for all but one of our business groups. The last thinks they are good enough to do their own thing. Fine. Their applications group has about 3x the staff as ours so let them do their own thing. OK....
Now they want full access to our DB or an API so that they can lookup their historical requests. Ummm... we'll do an API thank you. Blueprint it up to require the key and their CustomerID... No, authentication/authorization is not needed as this will be an internal API only. Oh we're starting to go downhill now....
From prototypes I had to do their requests manually, had this new API up in a couple of days.
Now the problems come into view.
1. On our side of the wall, what do you mean there is no auth required.
2. And from them, we don't know our key. Whomever on their side compiled an assembly so that they could just use their Alias for identification, and they don't have the source code.
Ugh...
So the politicians settled on this mind-number yesterday afternoon:
1. A new GUID will be created on our end for each business group.
2. A new endpoint is created where they give us their alias, and we will return this new GUID.
3. Prior endpoints will be rewritten-
3A. Instead of their license key being required, they will pass in their alias instead.
3B. The requests will require an Auth request header, containing the new GUID.
Yep... glad I have today off. Need to have it ready by Monday end-of-business.
Director of Transmogrification Services
Shinobi of Query Language
Master of Yoda Conditional
|
|
|
|
|
Sure, now they say no authorization is required because it is internal-only. That's often the convenient statement of the moment. However, reality often diverges from the agreements of the moment. I would get something in writing, signed by a CIO or executive of your choice, saying that no security is required. This is because when this gets hacked and your database is trashed you need to be able demonstrate you were ordered to allow open access.
This is the classic case of a cover-your-backside requirement because you have been asked to do something absurd.
"They have a consciousness, they have a life, they have a soul! Damn you! Let the rabbits wear glasses! Save our brothers! Can I get an amen?"
|
|
|
|
|
|
Just because you can... Means it's gonna happen! 
|
|
|
|
|
i usually disable the buttons using javascript as soon as they're clicked and keep them that way until the page refreshes.
it helps
When I was growin' up, I was the smartest kid I knew. Maybe that was just because I didn't know that many kids. All I know is now I feel the opposite.
|
|
|
|
|
Haha I had the same thing happen.
Sorry to laugh but mine was a bugger to find as well, even though the environment wasn't as complicated as yours.
System had been running for about 7 years.
It is for Government so their testers gave it a pounding and ticked it off as OK.
Then one day an end user said something to me about an issue so I looked through the logs.
There it was. Obscure error too. It was really rare but it only ever happened to about 3 users out of about 250.
I thought about it and then thought maybe double click.
Then tried but it all worked OK. Tried all sorts of things within this stage of a process.
Turns out that my double click technique is sh*t.
I practised to get it down from milliseconds to nanoseconds.
Yep got the error.
When I looked at the code I had a couple of instructions inserted before I disabled the button.
Shifted the disable to when the click event happens and then all good.
I felt a little embarrassed about it, should have checked the code first, but gee wiz, these 3 users were Olympians of the double click, albeit in a single click application.
End users are often Faster, Higher, Stronger or Stupid.
"Rock journalism is people who can't write interviewing people who can't talk for people who can't read." Frank Zappa 1980
|
|
|
|
|
grralph1 wrote: End users are often Faster, Higher, Stronger or Stupid.
Not necessarily - it could just be an old mouse. One of the things uSwitches can do when they get old is "bounce" more, and if the time between successive bounces is larger than the hardware (or driver) "debounce" period, you get two clicks for a single press. (Normally there is a cap or similar to swallow the quick bounces, but as the contact surfaces get dirtier and more worn the bounces can be further apart.)
Switch Bounce and How to Deal with It[^]
Sent from my Amstrad PC 1640
Never throw anything away, Griff
Bad command or file name. Bad, bad command! Sit! Stay! Staaaay...
AntiTwitter: @DalekDave is now a follower!
|
|
|
|
|
Good point.
I am aware of this as I come from an electronics background.
Plus switch bounce can be an intermittent problem as well, that can come and go, which makes it worse and harder to detect.
However this system was a shared station that is in each outlet.
So all users in each outlet used the same machine for the function that it was designed for.
So in this case it was the super speed of 3 users, at different outlets, if i remember correctly, that were the cause of the issue.
Well I should really rephrase that to;
No not switch bounce, the developer just stuffed up.
"Rock journalism is people who can't write interviewing people who can't talk for people who can't read." Frank Zappa 1980
|
|
|
|
|
grralph1 wrote: However this system was a shared station that is in each outlet.
So all users in each outlet used the same machine for the function that it was designed for.
grralph1 wrote: Faster, Higher, Stronger or Stupid.
I mean, some of them might be stronger than others.
Pro tip: Maybe some testers should get high too.
|
|
|
|
General 
News 
Suggestion 
Question 
Bug 
Answer 
Joke 
Praise 
Rant 
Admin 
Submit an article or tip
Then I tried it and behold, there it is! 