bssw.io
bssw.io copied to clipboard
betterscientificsoftware
BSSwF blog post - visually communicating design
This pull request adds a blog post that is part of my 2023 BSSw Fellowship on visually communicating elements of software design. I'd like to start the review process, but there are at least a few things left to do:
- [x] Add captions and numbers to figures
- [ ] Refine the layout of the images on the page
Note that some of the content linked in the blog post has not yet been finished, so this pull request should not be merged yet.
Hi @rafmudaf , @gonsie mentioned that you wanted to make some edits to your blog post. I plan to start work preparing your article for posting next week (the week of 6 May). It would be most helpful if you could make your changes before then and let me know that it is ready from your perspective. Thanks
Hi @bernhold I've made the changes I discussed with @gonsie.
I think there might be some work to do to improve the readability and layout of the images. Is it straightforward to build the website locally? I watched the BSSw io Tutorial video hoping to get some insight into building the docs site, but I think I've included the topics in that video in my process already.
Hi @rafmudaf , unfortunately, there is no capability to build the site locally. I can work with you on the images. We do have a preview site that you'll be able to see how they look, but only the BSSw.io editorial team can rebuild it. So there will be a bit of back and forth. I'll try to get a preview up for you this weekend and email you when that's ready (we try not to expose the info in public to avoid attracting troublemakers).
That sounds good, @bernhold. I'll look out for the email, and I'll try to have the images refined for next week.
@bernhold I have a bit more work to do on this post. I saw that you listed the publish date as May 14. Is that my deadline for changes?
Specifically, I'd like to improve Figure 3 a bit and also improve the overall flow of the article. Since it was much longer initially, I removed whole sections and now it's somewhat choppy when you read it straight through. I made some improvements today, but I'd like to continue to iterate on it.
@rafmudaf thats a target, but I definitely want to publish it this week. Please keep me informed.
@davidbernholdt I've removed some of the text in that third image, so I think it will ultimately look bigger and a bit more readable.