Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add some extra details to docs #82

Merged
merged 3 commits into from
Jul 13, 2024
Merged

Conversation

ninjaPixel
Copy link
Contributor

@ninjaPixel ninjaPixel commented Jul 8, 2024

Hi, Ben! Thanks for creating this project. I heard you on the Syntax podcast and it was great timing as I was in the market for a self-hosted visitor analytics solution.

I hadn't used Cloudflare before and had a few minor stumbles when going through the README, similar to issue #71 .
I've added a little bit more detail to the README and have added some screenshots too.

I created a /docs directory for the screenshots but I also realise that you load existing screenshots from an external URL. I'm happy to follow that pattern if you want to save my screenshots somewhere else.

Thanks!

Comment on lines +124 to +130
- There should be no application state outside of CF Analytics Engine
- e.g. no additional relational database like MySQL, PostgreSQL, etc.
- That means no `users` table, no `sites` table, etc.
- This also means retention will be limited by what CF Analytics Engine provides. While it could be possible to stand up a "hit counter" for long-lived data (e.g. years), that would mean another database, which we will not pursue.
- We prioritize backwards compatibility
- New `metricsDataset` columns can be added, but old columns cannot be removed or renamed (they can however, be "forgotten").
- That also means it's okay if a feature only works during a period where the data is active.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Changing * to - for unordered list items to make this section consistent with how the other unordered lists are declared. Note that there is no visual difference in the rendered document.

@benvinegar
Copy link
Owner

Hey, thanks for submitting. I just got back from a vacation but hoping to look at this soon.

Copy link

codecov bot commented Jul 13, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 71.19%. Comparing base (a7d3a73) to head (d18f765).

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #82   +/-   ##
=======================================
  Coverage   71.19%   71.19%           
=======================================
  Files          25       25           
  Lines        2638     2638           
  Branches      147      147           
=======================================
  Hits         1878     1878           
  Misses        755      755           
  Partials        5        5           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@benvinegar benvinegar merged commit 676139f into benvinegar:main Jul 13, 2024
3 checks passed
@benvinegar
Copy link
Owner

@ninjaPixel Merged – thanks!

benvinegar added a commit that referenced this pull request Dec 20, 2024
* docs: add some extra details to the Deployment section

* docs: add screenshots

* Fix typo

---------

Co-authored-by: Ben Vinegar <[email protected]>
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.

2 participants