News for hackers. Stuff that matters.

Show HN: Watermelon – open-source VSC ext. to document code and view Git blame

https://github.com/watermelontools/wm-extension

Hey there HN! We're a pair of devs looking to get feedback for our open-source project.

We're remote engineers who have contracted for many clients overseas. There's a problem that all codebases share: Onboarding devs to a new codebase is hard no matter what.

We're also open-source engineers and learned about the techniques used in OSS to tackle the problem. Please give us your feedback.

Homepage: https://watermelon.tools/

Repo: https://github.com/watermelontools/wm-extension

Install: https://marketplace.visualstudio.com/items?itemName=Watermel...

( 42 comments | 84 points | on HN )
Re:Show HN: Watermelon – open-source VSC ext. to document co... by Loic on Friday May 13, 2022 @04:41PM (#31372329)
nicorojas9, alan_arguello, jgarzonebrath and oarojas were all accounts which are between 2 year and 90 day old without any comments.

Suddenly they decided to comment for the first time on this specific submission.

And all within one hour.

And all to basically write the same thing.

The Watermelon authors are lucky or maybe it is Friday the 13th.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by alan_arguello on Friday May 13, 2022 @06:40PM (#31373265)
Always happy to verify my identity Loic.

I saw that Watermelon was on HN and I did made a first comment, because I have been following the project and I like to support other founders who happen to be my friends.

And indeed, they are "lucky" to have people that like the team and project. Hope that it is the same case with you and people that you know :).

Re:Show HN: Watermelon – open-source VSC ext. to document co... by Loic on Saturday May 14, 2022 @03:30AM (#31375839)
Then, as a good friend, take the time to provide a comment with more insights. We will all benefit from them. I looked at the comments because the website has not a lot of information and I was expecting to learn more from the comments.

Note: This is the first time I looked at the origins of comments in a submission because they really looked like fake comments and this annoyed me terribly as I want HN to stay free of them.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by alan_arguello on Saturday May 14, 2022 @11:29AM (#31378895)
That's true thanks. I'm a heavy user/consumer of YC content, SUS and events, but not of HN. Indeed it would have been more useful for both the community and the team to provide an insightful comment.

Anyways, hope you get the opportunity to try Watermelon and give them an unbiased opinion (as I probably would do), which will help them :)

Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @04:45PM (#31372363)
Wow this Sherlock Holmes-level research.

Our close friends did notice we launched. Lol.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by melissalobos on Friday May 13, 2022 @05:48PM (#31372866)
> Wow this Sherlock Holmes-level research.

It isn't very hard to click on the usernames after you see some suspicious messaging from similar accounts.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by CRConrad on Tuesday May 24, 2022 @11:38AM (#31493510)
Recalibrate your sarcasm detector?
Re:Show HN: Watermelon – open-source VSC ext. to document co... by Kalmis on Saturday May 14, 2022 @06:48AM (#31376670)
I wonder what are the future plans and features of Watermelon? Currently it feels like it does not bring a lot, or any, new things to VS Code ecosystem.

- GitLens is the extension every Git user should have installed, and it for example automatically gives you the git blame on every line

Then depending a bit on the version control system & language used, there are "native" extension for PR and documentation.

- Github pull requests & issues integrates nicely with the GitLens blame - hover the blame and you'll see the PR. Also has bunch of PR & Issues related functionalities

- autoDocstring (Python) for generating documentation "automatically" inside the code, where it belongs IMHO.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Saturday May 14, 2022 @10:25AM (#31378206)
Hi and Ty for your comment. This is exactly the kinds of questions that we wanna see here because we learn new things with such.

1. GitLens is useful but it only gives you the author of a line, and the commit message. We can do way better than that as we keep indexing info from more sources + organize it in different ways

2. Similar as number 1. We will index info from more sources and organize it better.

3. Didn’t know about autoDocstring but it looks like a great analogous tool to JSDoc. We’ve used JS Doc and think it’s great for documenting functions. However, we believe there is an opportunity for documenting greater level stuff such as the architecture and the relations between modules.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by Kalmis on Sunday May 15, 2022 @02:57PM (#31389995)
Sounds good, keep up the good work!
Re:Show HN: Watermelon – open-source VSC ext. to document co... by sebmellen on Friday May 13, 2022 @04:42PM (#31372342)
Hey Esteban, it’s Sebastian. Huge congrats on your HackerNews launch!!!

I had the pleasure of working with Esteban (aka baristaGeek) at Cerebrum. Great guy. There’s a saying that the best employees go on to be founders, and I can definitely see that in what Watermelon is becoming. Very exciting!

And yes! The code onboarding problem is always there. Watermelon providing that historical context is huge.

P.S. I just happened to find this at the bottom of the homepage. I had no idea Esteban would be posting here, I just browse HN a lot.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @05:14PM (#31372603)
Ty Sebastian! Yeah, Cerebrum was an awesome school.

Hope we're adding value with our historical context tool. Always glad to listen to your feedback.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by estebandalelr on Friday May 13, 2022 @07:03PM (#31373445)
Haha! "The other Esteban" here. Thanks for the comment, we've been hard at work. Hope to see you again soon!
Re:Show HN: Watermelon – open-source VSC ext. to document co... by jgarzonebrath on Friday May 13, 2022 @01:42PM (#31370483)
This concept is very cool. Interesting approach to visualize git blame and the team behind looks outstanding. Congrats guys, downloaded.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @02:26PM (#31370965)
Ty very much! We're glad we're adding value.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by sanketc on Friday May 13, 2022 @10:43PM (#31374645)
Love this! If you can pull in info from Slack/Discord convos that would be a big unlock. Do you plan to make this available to private repos shortly? Would love to try it out on an internal one, as we always find ourselves repeating information when onboarding new team members.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Saturday May 14, 2022 @10:17AM (#31378135)
Hi there and Ty!

1. We are already available for private repos. If you authenticate you’ll be able to use us on any GH private repo

2. Yes! We’re exploring integrating Notion, Jira, and Slack. Stay tuned!

Re:Show HN: Watermelon – open-source VSC ext. to document co... by miguelmichelson on Friday May 13, 2022 @05:01PM (#31372501)
I've been following Esteban's project recently, I like the product very much it's really handy to give context on what we do on daily basis (coding in my case :D). Build in the open is the way to go, best of lucks to the watermelon team!
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @05:07PM (#31372536)
Ty! Yeah we're an open company (open source, open roadmap, open salaries) and it has worked great.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by nicorojas9 on Friday May 13, 2022 @03:21PM (#31371577)
Hey, congrats on the open source approach! I do have a question on your strategy though. How do you get valuable feedback from users? What incentive does your users have in order to communicate with you back and forth trying to build a better product?
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @03:30PM (#31371672)
Ty! Open source is a very important part of our philosophy.

1. We track which GitHub usernames and repos that use Watermelon, it's the only thing we track. This allows us to go to people and ask them for more detailed feedback. We also get feedback from stargazers and forkers. Because we're open source, people also leave GH issues.

2. The incentive is something very basic: They wanna see a better version of this out there in the world.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by no_circuit on Friday May 13, 2022 @04:03PM (#31371979)
According to the repo it is more than just username and repo, the local user account and email address is also tracked [1]. I'd argue that you shouldn't be recording email since that is PII. And repo name and repo owner since the names could be considered trade secrets within organizations. Recording the local user account could be considered sensitive information since it could aid hacking the organization. Finally I don't think you should be recording the GitHub username as well since usage patterns could be analyzed to determine the timezone of the user, which is also considered sensitive personal information in some large corporations that track user behavior data.

Sorry, but I don't think you should request feedback from users without their explicit permission. Isn't there a feedback mechanism built into VSCode already, or make and affordance for one in your plugin UI? Maybe at best generate a random install ID that can be reset for analytics and session tracking? VSCode has guidelines for this, see [2].

[1] https://github.com/watermelontools/wm-extension/blob/c389125...

[2] https://code.visualstudio.com/api/extension-guides/telemetry...

Re:Show HN: Watermelon – open-source VSC ext. to document co... by estebandalelr on Friday May 13, 2022 @04:36PM (#31372292)
Hey! This is great insight, honestly wasn’t aware and you’re right. Any chance of sending a PR for this? Would you be interested on talking about employment with us (open to part time)? We are a fully remote company.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by no_circuit on Monday May 16, 2022 @07:06AM (#31395531)
Cool, it's great you'll look into it! Although I like working with dev tools, unfortunately I can't take on additional projects at the moment.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Monday May 16, 2022 @10:44AM (#31398148)
Please let us know if anything changes on your side!
Re:Show HN: Watermelon – open-source VSC ext. to document co... by igomeza on Friday May 13, 2022 @03:50PM (#31371870)
Used it some weeks ago to understand a package in the kubernetes codebase. Its great for getting insights on an unfamiliar project
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @03:54PM (#31371916)
Thanks! If you have any suggestions for us please open up an issue on our repo.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by a-dub on Friday May 13, 2022 @04:46PM (#31372377)
super cool! have long been interested in tooling for making code archaeology easier!

any plans for building extensions for various issue/work tracking systems, wikis, email archives, etc? i've longed for comprehensive views across tickets, pull requests, bug reports and wikis for all relevant knowledge for a given effort in past.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @05:18PM (#31372640)
Yes! We're exploring Jira, and Notion integrations mostly. We're discarding Slack for the moment because of the technical feasibility, but would be something we look further down the road.

What's your opinion about the create docs direction we're exploring to complement your Indiana Jones coding? (Love your "code archeology" term).

Re:Show HN: Watermelon – open-source VSC ext. to document co... by a-dub on Friday May 13, 2022 @06:27PM (#31373180)
that is less interesting to me personally as that's often handled locally. (most sites with many projects will have some sort of locally customized project boilerplate or template to start with).

i'm more interested in tooling that gives as much context as possible for why something is the way it is. code ages like a novel would as passed through the telephone game. the more context that is readily available for each generation of changes, the more consistent the design remains in the long run.

also, it's incredibly handy when in emergency breakfix situations.

Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @06:29PM (#31373195)
Ty very much! We'll keep this in mind.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by sebmellen on Friday May 13, 2022 @04:50PM (#31372412)
It looks like integration with ticketing systems is on the roadmap https://github.com/orgs/watermelontools/projects/1.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by alan_arguello on Friday May 13, 2022 @02:36PM (#31371074)
Amazing concept! I have been following the process and I'm really excited to see what you guys accomplish. Congrats!
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @02:39PM (#31371107)
Ty Alan! It's great to be surrounded by smart technical people like you.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by estebandalelr on Friday May 13, 2022 @12:54PM (#31369964)
Hey! Esteban, the CTO of watermelon here. Feel free to ask any questions, open to answering them :)
Re:Show HN: Watermelon – open-source VSC ext. to document co... by sebmellen on Friday May 13, 2022 @04:47PM (#31372387)
So many Estebans…
Re:Show HN: Watermelon – open-source VSC ext. to document co... by alexrecouso on Friday May 13, 2022 @06:27PM (#31373178)
I've been following this project for so long, super cool to see you guys here!
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @06:30PM (#31373198)
Ty! Always looking to learn about new ways to add value to you
Re:Show HN: Watermelon – open-source VSC ext. to document co... by oarojas on Friday May 13, 2022 @02:28PM (#31370980)
Love the open-source approach. Congrats! Great product
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @02:31PM (#31371016)
Ty! This has been an important pillar for us since day 1. We believe a lot in the open source ethos, its transparency, and its collaborativeness.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by revenga99 on Friday May 13, 2022 @04:24PM (#31372163)
Curious why it is named watermelon.
Re:Show HN: Watermelon – open-source VSC ext. to document co... by baristaGeek on Friday May 13, 2022 @04:32PM (#31372242)
It's the happiest fruit and has emoji :)