menu
announcement

Spectrum is now read-only. Learn more about the decision in our official announcement.

Stepsize

Stepsize is a SaaS solution to measure and manage technical debt. Join our new community and kick off a conversation!

Channels
Team

Stepsize watercooler

September 3, 2019 at 10:38am
Show previous messages

November 15, 2019 at 1:27pm
hi, I want to know how to use tech debt tracker in vscode
it's not work for me
Hi ! Thanks for getting in touch :)
Hmm that’s unusual. Can you let me know what happens when you install the extension please? Does it not show up - or does it load but doesn’t work as expected?

November 27, 2019 at 6:01pm
Hello! The comment density is quite punishing. I prefer more comments. Is there anyway to reverse the comment density value or to make it more forgiving of comments?
like-fill
1
Hey 👋! Thanks for bringing this to our attention.
We've toyed with the idea of allowing some metrics to be user-configurable. I guess it makes sense for the comment density metric to be one of those based on your experience.
Could you let me know how much of an issue you think it is for you? Is it common for you to find that your functions are rated poorly only because of their comment density?
How about the other metrics? What would you say your opinions are on those?
Thank you for being responsive :) That's really nice. I am using the VSCode extension.
I have found that my functions and classes are graded down mostly because of comment density.
The next most common lower grade category is nesting. Which downgrades from green to yellow at the second nested if clause.
An example of a code block graded in yellow in both nesting depth and comment density is:
client.on('message', (message) => {
if (this.authenticated === false) {
// Redirect this user's messages through the authenticator.
this.authenticate(message);
} else {
this.message.receive(message);
if (this.message.error.length > 0) {
console.log(`Error: ${this.message.error()}`);
}
}
});
You're welcome :)
Thanks for the information and code example. Really helpful! I'll bring this up to the rest of team tomorrow and I'd expect our product manager to get in touch with you soon after.
Is the rest of the extension working well for you - is there anything else I can help with at all?

November 28, 2019 at 1:39pm
Hey , thanks a lot for sharing that feedback, it's really helpful!
About the comment density – do you think our yellow/red thresholds are too strict, or do you think the metric in itself is not great?
Yes clearly this code is fine – we'll take a closer look at these two metrics based on that example, thanks 🙏
We might need to do a better job to make that clear, but the main aim of the extension is to draw your attention to functions rated D / E with many issues. A function rated A or B is generally considered good enough, and even if one or two metrics are yellow there are typically more important things to worry about. Is that the impression you have? Or do you feel like it pushes you to make every piece of code green all around?
, thank you for being attentive. I haven't take a look at the metric; I have experience only with the colored values presented to me within my IDE :)
I would definitely take a good look at refactoring blocks rated D and E. My initial impression was that blocks rated B (maybe C, too) are good enough, but the fact that the extension brought it to my attention meant that there was something wrong with my code. I'm sure everyone has different reactions. I'm always looking for different ways to be a better coder which is why I wanted to ask about the comment density.
If I hadn't spoken with you I think it would have bothered me to not have all green code all around.

November 29, 2019 at 7:33pm
thanks again for taking the time to share your thoughts! We've just finished our planning session for next week – based on your feedback and those of others we'll make some tweaks to the comment density metric which should result in it being green for snippets like the one you sent 👌
We don't have immediate plans to tweak the nesting metric or to make the metrics' thresholds configurable, but it's something we're thinking about. The main reason is that we're trying to present an objective view of code quality based on empirical research, and this isn't quite compatible with configurable thresholds. But these are early days, your feedback has been well received and will be considered for anything we do next 🙏

December 10, 2019 at 7:52pm
Hi! https://www.stepsize.com/ does not unfurl on Slack.
like-fill
1
just wanted to share in case this is not something you are already aware.
Hi Augusto :) thanks for letting us know! Really kind. Just to confirm, are you referring to the URL preview? If so, when you share other URL’s, I assume they preview normally?
Yep sorry i wasn't clear. See for example how https://terms.stepsize.com/ does have a preview.
Got it! Thanks again. We’ll look into this :)
Let me know if there’s anything else you’d like to point out about the extension. I hope you’re finding it useful !

December 12, 2019 at 11:42am
Hi 👋. The issue with the URL preview should be fixed now. Not a game changer, I'm sure, but just letting you know 😊 Thanks again for reporting it.
Show more messages