├── .gitignore ├── .vscode └── settings.json ├── icon.png ├── .github └── workflows │ └── release.yml ├── CHANGELOG.md ├── package.json └── README.md /.gitignore: -------------------------------------------------------------------------------- 1 | node_modules 2 | *.vsix -------------------------------------------------------------------------------- /.vscode/settings.json: -------------------------------------------------------------------------------- 1 | { 2 | "gitdoc.enabled": false 3 | } -------------------------------------------------------------------------------- /icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/lostintangent/thinking-in-code/HEAD/icon.png -------------------------------------------------------------------------------- /.github/workflows/release.yml: -------------------------------------------------------------------------------- 1 | name: Release 2 | 3 | on: 4 | release: 5 | types: 6 | - created 7 | 8 | jobs: 9 | Release: 10 | runs-on: ubuntu-latest 11 | steps: 12 | - name: Checkout 13 | uses: actions/checkout@v2 14 | - name: Install Node.js 15 | uses: actions/setup-node@v1 16 | with: 17 | node-version: 14.x 18 | - run: npm install 19 | - name: Publish to VS Marketplace 20 | run: npx vsce publish 21 | env: 22 | VSCE_PAT: ${{ secrets.VSCE_PAT }} -------------------------------------------------------------------------------- /CHANGELOG.md: -------------------------------------------------------------------------------- 1 | ## v0.0.11 (08/22/2021) 2 | 3 | - Adding [WikiLens](https://aka.ms/wikilens) as a new dependency 4 | 5 | ## v0.0.10 (07/23/2021) 6 | 7 | - Reintroducing Drawio as a child dependency 8 | 9 | ## v0.0.9 (07/06/2021) 10 | 11 | - Removed GitDoc and Drawio as child dependencies 12 | 13 | ## v0.0.8 (07/06/2021) 14 | 15 | - Correctly set the extension kind 16 | 17 | ## v0.0.7 (04/07/2021) 18 | 19 | - Added the [Draw.io](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio) extension to the pack 📊 20 | 21 | ## v0.0.6 (03/21/2021) 22 | 23 | - Added Twitter links for the "inception" of each project within the pack 24 | 25 | ## v0.0.5 (03/21/2021) 26 | 27 | - Improved the premise definition 28 | 29 | ## v0.0.4 (03/20/2021) 30 | 31 | - Add more gif examples 32 | 33 | ## v0.0.3 (03/20/2021) 34 | 35 | - Added link for office hours calendar 36 | 37 | ## v0.0.2 (03/20/2021) 38 | 39 | - Improve `README` description for included extensions 40 | 41 | ## v0.0.1 (03/20/2021) 42 | 43 | 🚀 Initial release! 44 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "thinking-in-code", 3 | "displayName": "Thinking in Code", 4 | "publisher": "lostintangent", 5 | "description": "Collection of extensions to enable a richer environment for writing, thinking, and learning about code.", 6 | "icon": "icon.png", 7 | "version": "0.0.11", 8 | "repository": { 9 | "type": "git", 10 | "url": "https://github.com/lostintangent/thinking-in-code" 11 | }, 12 | "engines": { 13 | "vscode": "^1.51.0" 14 | }, 15 | "categories": [ 16 | "Extension Packs" 17 | ], 18 | "extensionKind": [ 19 | "ui", 20 | "workspace" 21 | ], 22 | "keywords": [ 23 | "learning", 24 | "gist", 25 | "playground", 26 | "notes" 27 | ], 28 | "extensionPack": [ 29 | "vsls-contrib.codetour", 30 | "vsls-contrib.gistfs", 31 | "codespaces-contrib.codeswing", 32 | "hediet.vscode-drawio", 33 | "lostintangent.wikilens" 34 | ], 35 | "devDependencies": { 36 | "vsce": "^1.95.0" 37 | }, 38 | "scripts": { 39 | "package": "vsce package" 40 | } 41 | } 42 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # 🧠 Thinking in Code 2 | 3 | _Thinking in Code_ is a curated set of VS Code extensions, which collectively seek to provide a [learning environment](http://worrydream.com/#!/LearnableProgramming) that can improve the comprehension & [interactivity](https://blog.ncase.me/curse-of-the-chocolate-covered-broccoli-or-emotion-in-learning/) of code, support the management of code-centric [knowledge bases](https://thesweetsetup.com/pkm-intro-for-creatives/) / [digital gardens](https://maggieappleton.com/garden-history/), and help developers ["think better"](https://alistapart.com/article/writing-is-thinking/) as part of their daily routine. Maybe, just maybe, it can help make your development experience more fun 🎢 4 | 5 | | Included extension | How can it help? | 6 | |-|-| 7 | | 🗺️ [CodeTour](https://aka.ms/codetour) - Record and playback guided tutorials for codebases (aka "tours").

|
  1. Like a table-of-contents for your codebases
  2. Enables easier onboarding/knowledge sharing
  3. Documentation is provided where developers actually work: their editor.
  4. Tours are interactive, and can automate commands, inject code snippets, run shell commands and more!
  5. GUI recorder makes it easy to author and maintain tours (let's make writing fun!)
| 8 | | 💃 [CodeSwing](https://aka.ms/codeswing) - An interactive coding environment for building web applications playgrounds (aka "swings").

|
  1. Provides an interactive, CodePen-like playground, with a super rich live preview
  2. Supports all popular [web languages](https://marketplace.visualstudio.com/items?itemName=codespaces-Contrib.codeswing#language-support) (e.g. TypeScript, Scss) and [component libraries](https://marketplace.visualstudio.com/items?itemName=codespaces-Contrib.codeswing#components) (e.g. React, Svelte, Vue)
  3. Works offline, and your code can be stored anywhere
  4. Swings can be saved and shared using GitHub Gists (see below)
  5. Create and edit playgrounds, without sacrificing your personalized editor setup (e.g. theme, keybinding,
| 9 | | 📘 [GistPad](https://aka.ms/gistpad) - Manage and access developer notes and code snippets, stored as GitHub Gists and repos.
|
  1. Allows you to capture todos, journals and [daily notes](https://marketplace.visualstudio.com/items?itemName=vsls-contrib.gistfs#scratch-notes), so you can stay organized from your editor
  2. Easily store and access code snippets, to surpercharge your workflow
  3. Review and commment on gists and repos via [editor-integrated commenting](https://marketplace.visualstudio.com/items?itemName=vsls-contrib.gistfs#gist-commenting)
  4. You own your data, and you can make use of VS Code's amazing ecosystem of extensions
| 10 | | 🔎 [WikiLens](https://aka.ms/wikilens) - Provides a rich markdown-based notetaking experience for GitHub repos.
|
  1. Supports Roam/Obsidian-like wikis, including `[[references]]` and `#tags`
  2. Allows viewing and navigation backlinks via a `Wiki` file tree and inline comment view.
  3. Can embed pages into files, in order to compose your documents however you'd like.
  4. You own your data, and you can make use of VS Code's amazing ecosystem of extensions
| 11 | | 📊 [Draw.io](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio) - View and edit rich diagrams directly within the editor.

|
  1. Create diagrams, using a fully offline canvas, that's themed to match your editor preferences
  2. Allows you to create SVGs or PNGs, so that your diagrams can be embedded into other documents
  3. You can link nodes/edges on the diagram to spans of code
  4. Provides a fully real-time collaboration experience (see below)
| 12 | 14 | 15 | ## 🧑‍🤝‍🧑 [Think Different](https://en.m.wikipedia.org/wiki/Think_different), [But Together](http://aka.ms/vsls-why) 16 | 17 | While thinking requires focus, learning can benefit from collaboration with others. As a result, every extension in this collection is collaborative by default, and provides rich integration with [Live Share](https://aka.ms/vsls) (real-time co-editing and debugging for VS Code). This makes it easy to incorporate these writing/thinking experiences into your existing [collaborative workflows](https://aka.ms/vsls-usecases). 18 | 19 | | Extension | Collaborative experience | 20 | |-|-| 21 | | 🗺️ [CodeTour](https://aka.ms/codetour) | When you start or navigate a tour, all participants will automatically follow along with you. This makes it easier to use code tours for onboarding/mentoring others on the team. | 22 | | 💃 [CodeSwing](https://aka.ms/codeswing) | When you open a swing, all participants will automatically open the same one. This allows you to share and co-edit a swing as a real-time collaborative playground. 23 | | 📘 [GistPad](https://aka.ms/gistpad) | Whe you open a gist-backed file, Live Share allows you to collaborate on it with other developers, as long as you have the `Live Share: Share External Files` setting enabled. | 24 | | 🔎 [WikiLens](https://aka.ms/wikilens) | If the guest had WikiLens installed, they'd be able to see and navigate the `Wiki` view along with the host. | 25 | | 📊 [Draw.io](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio) | Participants can open a `*.drawio` file, and see their cursors and edits in real-time. This enables a rich, whiteboard-like experience, that can enrich your pair programming sessions. | 26 | --------------------------------------------------------------------------------