Skip to content

Conversation

@jooohhn
Copy link
Contributor

@jooohhn jooohhn commented Aug 21, 2020

Notes I jotted down when diving into the JS SDK codebase. Consists of two parts

  • Comments I added in files
  • notes.md that contain bullet points about architecture, useful tips, etc.

Maybe we should make a CONTRIBUTING.md, Github wiki, or space in the SDK documentation to help introduce new visitors to the repo?

@jooohhn jooohhn marked this pull request as ready for review August 21, 2020 00:36
src/notes.md Outdated
- Use Amplitude Instrumentation Explorer to help development
- "Instrumentation" involves matters related to logging user actions (i.e. events)

# Concerns
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This one sounds like more useful to yourself. Only put notes which are useful for others to understand this SDK better.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess we should move all this notes to a contributing.md file as a setup guide.

src/notes.md Outdated
# Misc
- Readme.io used for documentation

# Ideas
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be also private to yourself.

src/notes.md Outdated
- E2E browser tests with sauce labs
- merge with node?

Question
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can convert these to concrete Q&As

src/notes.md Outdated
@@ -0,0 +1,25 @@
# Intro
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Again, do you think renaming this file to CONTRIBUTING.md would be a better option to make this to be a setup guide?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I moved src/notes.md to CONTRIBUTING.md and added a reference to it in the README.md quick start section

@jooohhn jooohhn merged commit ed3c638 into master Aug 24, 2020
@jooohhn jooohhn deleted the temp-documentation branch August 24, 2020 17:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants