khalidabuhakmeh,
@khalidabuhakmeh@mastodon.social avatar

There are some cool projects in the #dotnet space completely hampered by the lack of documentation and onboarding for core elements of the experience.

SmartmanApps,
@SmartmanApps@dotnet.social avatar

@khalidabuhakmeh
Re "onboarding", this is my biggest issue with #Microsoft doco.1. they never (despite good grammar rules) spell out what the acronyms are, and 2. never link to anything about that acronym, so if you don't know the acronym then the whole document just became completely useless to you. ALL documentation should be written in a way that even beginners can understand it (by including links to required background knowledge subjects). See https://dev.to/smartmanapps/creating-maui-uis-in-c-1adf for examples

jchannon,
@jchannon@hachyderm.io avatar

@khalidabuhakmeh I’m too busy making millions of pounds to document my leftpad library

khalidabuhakmeh,
@khalidabuhakmeh@mastodon.social avatar

@jchannon That’s EXACTLY the library I was talking about. Thank you for recognizing your fault in all of this.

jchannon,
@jchannon@hachyderm.io avatar

@khalidabuhakmeh no worries. I see your annual subscription is due soon. I will discount it to $100000 per year

khalidabuhakmeh,
@khalidabuhakmeh@mastodon.social avatar

@jchannon I’ll check my couch cushions to see if I have enough spare change lying around. If not, I’ll have to check the cupholders in my Lambos.

chrissie1,
@chrissie1@hachyderm.io avatar

@khalidabuhakmeh @jchannon i see you people need a personal assistant, i’m free and very good.

esg,
@esg@hachyderm.io avatar

@khalidabuhakmeh or the doc is only in video format....

kstatz12,
@kstatz12@discuss.systems avatar

@khalidabuhakmeh documentation is either missing, out of date or obtuse. I don't know which I prefer most

candoumbe,

@kstatz12 @khalidabuhakmeh
I'm the author of the https://github.com/candoumbe/datafilters library.
Writing docs is hard, writing good docs is even harder.
I'm trying my best to write a documentation that helps to use the library

Please y'all feel free to take a look/open issues/PRs to improve the documentation and forget to 🌟 if you like the project

khalidabuhakmeh,
@khalidabuhakmeh@mastodon.social avatar

@candoumbe @kstatz12 That looks like quality documentation. The only comment I would make is that some example of interacting with a data source would cement how and when to apply the filter. Otherwise, it looks fantastic.

  • All
  • Subscribed
  • Moderated
  • Favorites
  • dotnet
  • DreamBathrooms
  • thenastyranch
  • osvaldo12
  • magazineikmin
  • GTA5RPClips
  • rosin
  • InstantRegret
  • Youngstown
  • slotface
  • ngwrru68w68
  • kavyap
  • khanakhh
  • Durango
  • mdbf
  • JUstTest
  • everett
  • ethstaker
  • normalnudes
  • cisconetworking
  • tacticalgear
  • cubers
  • modclub
  • provamag3
  • Leos
  • tester
  • anitta
  • megavids
  • lostlight
  • All magazines