4
9 Comments

How are you managing reusable code snippets and code notes?

What tools are you using to manage reusable code snippets and your notes? Either personally or as a small team?

Edit for clarity: By code snippets I'm referring to code that you or your team will probably reuse and want to document somewhere.

on June 26, 2020
  1. 2

    You can't go wrong with https://gist.github.com/ (you can even add code directly to a Gist from IDE's like WebStorm), and maybe a dedicated Slack channel where you share all these gists. Gist by the way has full version control capabilities like any file on GitHub, so you can update your scripts and keep track of the changes.

  2. 1

    I've got both VIM and VS Code set up to handle common snippets, including snippets with certain parts that change (i.e., snippet variables).

    If I need to share with others, I use a gist or just send it via chat. I haven't ever wanted to document a snippet itself since the all the source code is in git (and mostly documented) already.

    What issues in your workflow are leading you to ask this question?

  3. 1

    Well, from my experience when you are a part of a small dev team (like 2 people) you can use the Slack channel. Also, most of the snippets will be in your priv messages :D
    From my experience, when you are a part of a bigger team (>2), the best place is the one where everyone has access and doesn't need to know another tool.
    In my team, we are using https://guides.github.com/features/wikis/ because everyone knows the Github and it's the tool that we use already.
    But keep in mind that the biggest issue to manage the reusable code snippets is that someone has to have goodwill to document these short instructions XD

  4. 1

    Evernote is good for this.

  5. 1

    Like @herval I'm not sure what you mean by managing code snippets, but for notes I use Trello which is where my tickets are and notes and comments are related to them.

    1. 1

      Just edited for clarity.

  6. 1

    Why do you need to “manage code snippets”?

    1. 1

      Hey @herval, edited for clarity.

  7. 1

    This comment was deleted 4 years ago