![]() I’m sure you’re incredibly busy Jay and I can only imagine the time you could have and what you could do with it, were things just a little different. That probably sounds harsh, as this place is really very giving and helpful, but… although it’s getting better, that’s frequently what’s going on. This place should not be a triage for what went wrong with documentation fundamentals in the first place. What’s not great is attempting to explain to someone else that their issue is because of a ‘feature’ not documented anywhere that you may or may not have learned about on a messageboard at some time in the past, and to which they’d have no hope of discovering on their own. It’s excellent that things are being developed that I might discover by accident. Documentation is the soul of any code-based project - how(or if) - it’s maintained and loved is almost always a strong predictor of the long term success or death of any such thing. The issue I’m speaking to is more in line with how others will ultimately decide if Desmos is - or is not - for them.Īnd it’s about project health, maintenance, and long-term education community support… or not. You’re more than helpful, it’s great, believe me. I’ve mentioned this before so I don’t want to just keep repeating myself, but it really does matter. You’d just see far far increased adoption, happier users, and far increased leadership capacity. Many of the questions here and countless hours could be saved were things documented well. There’s not even a search UI on the documentation page. I use Desmos a lot and I could not find any information about this issue. This issue we’re discussing here is a pretty superficial example, but it illustrates the point. It’s consistently the number one barrier when I’m trying to sell this to other teachers. Not to be overly critical but… and I’m trying to say this in a really considerate way… but the lack of documentation is a major source of issues for platform adoption and it drives people away. I think the larger issue here goes back to documentation. It doesn’t sound particularly semantic in the context of Desmos Activities, but I do understand. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |