Comments (9)
I implemented a swagger documentation solution in my own repo a few days ago. We really could go with swag and redoc hosted with github pages.
Maybe with a new repo for the html and yaml file so this one is not polluted to much. Implementation in pipelines is also straight forward.
from server.
Thank You @eikendev for fast response. I understand. Work in progress. Thought that just client is in beta state. Nevertheless, maybe I can help You with this?
I'm very thankful for helping hand, maybe we can discuss about it via @stonson:matrix.org ? (Using sqlite, was not created automatically)
from server.
For pushing the documentation to the website repo we will need an api token for that repository set here as a secret. We can use the push-a-file-to-another-repository, push-directory-to-another-repository actions or do it ourself (git clone => git commit => git push) to get the documentation there. Any preferences?
from server.
We got a new little page running at pushbits.io. @CubicrootXYZ worked out a way to neatly document the API, available here.
from server.
Agree. Integrating with Swagger would be a bonus. And preferably (for the API at least) auto-generate from code and comments. Would also check Gotify here for guidance.
from server.
@eikendev could You also please add initialization docs. I'm fighting to resolve endless issues. Need to read Your code do use it.
In example I want to try Your solution.
- add docker-compose
- add to reverse-proxy
- run - first failure, missing db -should by created by myself right? Then, created.
- errors with config, ok, config updated
- error with adding application - missing table users. Do I need to create that table, what columns, what types, how many other tables also, I can see that table applications is also needed?
- server crashing due to trying to write into read-only db etc. etc.
If some action are required on initialization please write about it.
from server.
Hi @kamilr, thanks for your message. I agree that this is an important issue, but I did not get to properly set this up. While adding detailed docs is great for the users, it induces quite a bit of overhead for developers: each change might require us to update the docs, too. So I won't promise to fix this in the near future, but will keep in as one of the next major steps of this project. Also, more ideas are truly welcome.
However, I would like to help you sort out your specific problems. Can you tell me a bit more about your setup? What database backend did you use? How did your compose file look like (remove sensitive info)? Are you using Podman or Docker?
When using sqlite, the database file should be created automatically with the correct permissions and all required columns.
from server.
I created a new repository for this: pushbits/website. Happy to start with your proposed solution. Do you want to create a pull request? Later, we might want to wrap docsy or something similar around it.
from server.
Let's move the discussion to #37.
from server.
Related Issues (20)
- Add message formatting options HOT 2
- Add "delete" option for messages HOT 3
- API HOT 6
- Evaluate Semgrep as SAST HOT 1
- Provide Docker image tags other than 'latest' HOT 3
- Provide binary release
- Use more advanced logging framework HOT 3
- Provide examples for sending notifications in different languages HOT 1
- Add compatability with alertmanager webhooks HOT 2
- no content/title with element-ios HOT 10
- Latest Docker image is broken HOT 3
- Support configuration of trusted proxies
- Support direct configuration of HTTPS HOT 1
- Simpler API endpoint HOT 2
- Topic is changed after container restart HOT 10
- Include PushBits CLI in Docker image HOT 3
- Create an SBOM file
- `/_matrix/client/v3/createRoom: M_UNKNOWN (HTTP 400): Invalid user_id` HOT 4
- Request failed at creating new application HOT 6
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from server.