Your XMPP choice for .NET Core
XMPP is not dying and this library will help keep it alive. You can use this to develop a client for this popular messaging protocol and soon it will support small server instances.
Ubiety XMPP Core is available from NuGet
dotnet package install Ubiety.Xmpp.Core
You can also use your favorite NuGet client.
Here's a brief intro about what a developer must do in order to start developing the project further:
git clone https://github.com/ubiety/Ubiety.Xmpp.Core.git
cd Ubiety.Xmpp.Core
dotnet restore
Clone the repository and then restore the development requirements. You can use any editor, Rider, VS Code or VS 2017. The library supports all .NET Core platforms.
Building is simple
dotnet build
In case there's some step you have to take that publishes this project to a server, this is the right time to state it.
packagemanager deploy awesome-project -s server.com -u username -p password
And again you'd need to tell what the previous code actually does.
What's all the bells and whistles this project can perform?
- What's the main functionality
- You can also do another thing
- If you get really randy, you can even do this
Here you should write what are all of the configurations a user can enter when using the project.
Type: String
Default: 'default value'
State what an argument does and how you can use it. If needed, you can provide an example below.
Example:
awesome-project "Some other value" # Prints "You're nailing this readme!"
Type: Number|Boolean
Default: 100
Copy-paste as many of these as you need.
When you publish something open source, one of the greatest motivations is that anyone can just jump in and start contributing to your project.
These paragraphs are meant to welcome those kind souls to feel that they are needed. You should state something like:
"If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome."
If there's anything else the developer needs to know (e.g. the code style
guide), you should link it here. If there's a lot of things to take into
consideration, it is common to separate this section to its own file called
CONTRIBUTING.md
(or similar). If so, you should say that it exists here.
Even though this information can be found inside the project on machine-readable format like in a .json file, it's good to include a summary of most useful links to humans using your project. You can include links like:
- Project homepage: https://your.github.com/awesome-project/
- Repository: https://github.com/your/awesome-project/
- Issue tracker: https://github.com/your/awesome-project/issues
- In case of sensitive bugs like security vulnerabilities, please contact my@email.com directly instead of using issue tracker. We value your effort to improve the security and privacy of this project!
- Related projects:
- Your other project: https://github.com/your/other-project/
- Someone else's project: https://github.com/someones/awesome-project/
One really important part: Give your project a proper license. Here you should state what the license is and how to find the text version of the license. Something like:
"The code in this project is licensed under MIT license."