Suggestions

[cloneofghosts]

Adding a GitHub project to the repository might help you better keep track of things though in order for something to properly show up on the project they need to be an issue or a pull request. There's even support for custom fields so you can add priority as an example.

I haven't used projects on GitHub much myself though it does seem very similar to Trello which I've used in the past. The documentation for projects can be found here https://docs.github.com/en/issues/planning-and-tracking-with-projects

I thought of a couple more ideas that I'll add below:

Social Media
I know you have your own personal socials but having a dedicated PW account might be useful. Could post stuff about new versions, any maintenance, etc. I'm sure there's more but that was what I could think of off the top of my head.

Blog
I know you mentioned in another issue about writing up an analysis about the May 1st downtime and maybe having a dedicated blog page might be useful for this? I know other sites have used https://substack.com or even https://medium.com so it might be worth looking into to?

[cloneofghosts]

@alexander0042 Since Twitter seems to be imploding maybe having a PW Mastodon account instead? I don't know what people are going to be moving to but since you already have an account there it might make sense to create it there.

EDIT: What about the idea of creating issue templates for the repos? You could setup the following:

HA Repo
bug
enhancement
general

API Repo
bug
enhancement
apiable
general

You can set it up so it automatically adds labels to the issue and you could do it for bug/enhancement/apiable. I could also maybe setup a PR to do this?

[alexander0042]

LOVE the issue template idea! My first question is almost always "What location/ time is this for, what version is this, and what was the expected result". For HA, same thing, with the addition of what HA version they're using.

For the socials, I think it's easier to just keep using my personal ones, since I have them setup already. However, the blog idea is a great one, and I actually have three posts in the works (I need to as part of my AWS community builders membership anyway). The topics so far are the downtime analysis, new Kong infrastructure, and a summary of the cost structure. I'm thinking I'll just keep it on the main readthedocs url, since it's already setup and works pretty well

[cloneofghosts]

Issue Template - I haven't used this much myself but GitHub has issue form templates in beta which is what you can use in order for people to fill out certain information before posting. Here's the documentation I found for it https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository#creating-issue-forms. Also thinking it might be a good idea to automatically add Needs Review to items created through the template? Would be easier for you when checking through items to see which ones you haven't looked at yet.

Socials - Fair enough. I don't really see it advertised much anywhere (apart from your profile) and I don't see too many PW related posts but maybe it's just a case of using it more?

Blog - Again fair enough. Using the existing setup means there is one less website to maintain and might make things easier on your end.

[cloneofghosts]

@alexander0042 Was thinking of making a separate post somewhere for this but as mentioned here https://github.com/alexander0042/pirate-weather-ha/issues/30#issuecomment-1747280200 it would be nice to have either a github project for the 2.0 update or add a section on the roadmap.

With the new GitHub projects there is the ability to have separate repos share the same project though you'd want to turn off items being automatically added to the project, If you use a project it's easier to update and we can see how things are progressing without you having to update the roadmap file each time something is added/removed.

[cloneofghosts]

@alexander0042 I know you're busy but I definitely thing you either need someone to help you manage the GitHub repo or set something up to remind you to check in on the repo more often? From what I've noticed you'll be active for a bit and then go MIA for a few weeks at a time replying to a few issues.

[alexander0042]

Yes! Making an organization was a great suggestion, and I can see how it will really keep things contained. I did some testing and I don't think it should break too many links, since GitHub forwards everything, but I'm keeping an eye out for that. I'm going to archive alexander0042.github.io, and move the rest of them over.

[cloneofghosts]

I noticed you created a project for the 2.0 update. I linked it up to the HA repo so you can add items from that repo into there. I added a few items that are related to items already in the repo and added a priority and est completion date field which you can use if you wish.

Could always create another project for the items not included in the 2.0 update for people to keep track of?

[cloneofghosts]

I've created two more projects that might be helpful for you to keep track of things. I can't make them public unfortunately but the links are here

https://github.com/orgs/Pirate-Weather/projects/3 (HA)
https://github.com/orgs/Pirate-Weather/projects/4 (non 2.0 API items)

[alexander0042]

Thanks for making these! I really like this format, and also switched them to public. I'm taking a look at them now to see if there are any other changes/ adjustments that would make sense

[cloneofghosts]

Feel free to move things around as needed. May be a good idea to have the 2.0 and the api project linked on the road map page?

[cloneofghosts]

@alexander0042 I know it's the summer and you're likely busier than usual but I've noticed you've been MIA more than usual. I've been trying to help solve issues where I can but there's only so much I can help with before I need to send it off to you to look at.

[alexander0042]

I’m really sorry about this, and trust me that I notice it as well! I can’t say enough how much I appreciate you running the initial triage, and you are absolutely doing an amazing job with it. I totally see how it’s frustrating that there’s things that need me to do, and so I don’t take it lightly.

All I’ve got to add is to say that the worst of my scheduling issues are past for now, and so things should start rolling again! I really appreciate the tagging and assigning things, since that gives me a priority order when I sift though then.

[cloneofghosts]

No worries. I figured you were busy and with it being summer you're trying to get out an enjoy the weather while you can. Anything assigned to you or tagged as Needs Review are things that you need to look at though I'd focus on releasing V2.1 first.

I've also started using milestones to give a rough idea on what API version the issue will be added/fixed in. So the 2.1 milestone contains stuff which will release is 2.1 and 2.1.x just indicates that it will be added to the API in a patch to version 2.1.

[cloneofghosts]

@alexander0042 Just out of curiosity you still have the reminder to check the GitHub issues? I noticed that outside of urgent issues you sometimes go a week or two without replying to any issues.

[cloneofghosts]

@alexander0042 I tagged items in this repo and the HA repo as awaiting developer response for things that we are waiting on you for. Whenever you get the chance to look at them it'd be great. 😄

[alexander0042]

So sorry about that! What happens is that I get focused on something I think is almost done (in this case self-hosting), and think "I'll just reply to the other stuff once that's done". However, when it ends up taking longer than I anticipate, it creates these major issues. On it now!

[cloneofghosts]

So sorry about that! What happens is that I get focused on something I think is almost done (in this case self-hosting), and think "I'll just reply to the other stuff once that's done". However, when it ends up taking longer than I anticipate, it creates these major issues. On it now!

Didn't you have a reminder setup for it to remind you once a week to check the GH issues? Not sure if you still have it but could be useful in times when you get too focused on something.