Getting Started With CodeSee: Stories
Stories are a flexible tool to help you develop an understanding of your code, connect it directly to a specific line of code and then share both your code and your understanding with others creating an insanely powerful transfer of knowledge.
Stories in CodeSee let you build a narrative around the code in whatever order makes the most sense. You can tie snippets of code together from across the codebase, regardless of where the code appears in the structure of the files and folders.
Create a Story
- To create a new story in your data flow, expand the story bar on the far right of the screen. Add a title and optional description to your story.
- Click “Add Story Element.”
- Add content to your story element. These are free form blocks for you to:
- Make notes to yourself
- Add reminders to revisit particular locations
- Make plans to modify particular parts of code in the future.
- Mark the important parts of the execution flow.
- Anything you want really...
Link code to Stories
Story elements can be linked or connected to code that they are referring to. 1. Click on “Link to code regions.” 2. On the right side of the data flow checkboxes will appear allowing you to select which lines of code you want to connect to a story element. 3. Click the “Save links to regions” button to confirm your selections. 4. Once linked, the link icon will indicate that code has been connected to a story element. Clicking on this icon takes you to the link of code that is linked and highlights it for you.
Rearranging Story elements
If you are jotting down your initial thoughts and you would like to rearrange those elements into a different order, you can simply drag and drop those elements.
The text you write in stories is saved automatically. You’ll see a notification at the top of the stories panel when this is happening
Stories are private by default: only you can access the data flow and stories you’ve added.
If you want to share your story and data flow with others, click the Share icon, then choose:
- Public: anyone you share the URL with will be able to see your story.
- Organization: anyone with a CodeSee account using the same email domain as you will be able to see the story and data flow.