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

Blog: Technical properties of sustainable software #2139

Merged

Commits on Aug 19, 2024

  1. Configuration menu
    Copy the full SHA
    dc5e99f View commit details
    Browse the repository at this point in the history
  2. WIP: Finished basic formatting of copied text

    I also added a little more text.
    bartlettroscoe committed Aug 19, 2024
    Configuration menu
    Copy the full SHA
    ef9e86e View commit details
    Browse the repository at this point in the history
  3. Finished first fairly complete draft

    I still need to fill in some references and then I can do some more detailed
    editing.
    
    According to emails "count-words", this is currently 1935 words long.  (The
    target is about 1500 so this could use some editing to reduce length.)
    bartlettroscoe committed Aug 19, 2024
    Configuration menu
    Copy the full SHA
    3e1c928 View commit details
    Browse the repository at this point in the history
  4. Add hero image for tech properties of sustainable software blog article

    NOTE: I generated this hero image with Google Gemini Advancec using the
    prompt:
    
      generate an cartoon image of software depicted as a set of gears and showing
      the hand of a mechanic with a wrench
    
    This was the third of three generated images.
    
    If there is a desire for different hero image, it should not be too hard to
    generate one.
    bartlettroscoe committed Aug 19, 2024
    Configuration menu
    Copy the full SHA
    8a8d528 View commit details
    Browse the repository at this point in the history
  5. Link to hero image

    bartlettroscoe committed Aug 19, 2024
    Configuration menu
    Copy the full SHA
    8931966 View commit details
    Browse the repository at this point in the history

Commits on Aug 20, 2024

  1. Configuration menu
    Copy the full SHA
    a02593a View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    fa6193b View commit details
    Browse the repository at this point in the history
  3. WIP: Move references to bottom

    The tool wikize-refs.py is refusing the recognise the usage of the reference
    [se2s-book-2016].  Perhaps this will help?
    bartlettroscoe committed Aug 20, 2024
    Configuration menu
    Copy the full SHA
    c66dfbc View commit details
    Browse the repository at this point in the history
  4. Fix reference link for [se2s-book-2016]

    The error was confusing but I misspelled one usage
    bartlettroscoe committed Aug 20, 2024
    Configuration menu
    Copy the full SHA
    47e2792 View commit details
    Browse the repository at this point in the history
  5. Run wikize_refs.py on references

    This messed up the numbering and the links.  But I can fix those manually in
    the next commit.  I will not run this script on the file after this.
    bartlettroscoe committed Aug 20, 2024
    Configuration menu
    Copy the full SHA
    ca707b4 View commit details
    Browse the repository at this point in the history
  6. Manually fix off-by-one reference numbering error caused by wikize-re…

    …fs.py
    
    No sure what happened here but it was easy enough to fix manually.
    
    The tool wikize-refs.py needs more unit testing and test cases.
    bartlettroscoe committed Aug 20, 2024
    Configuration menu
    Copy the full SHA
    0ab4728 View commit details
    Browse the repository at this point in the history
  7. Full edit using Grammarly

    NOTE: I also added some missing reference placeholders [???] in case I want to
    add those.
    bartlettroscoe committed Aug 20, 2024
    Configuration menu
    Copy the full SHA
    a6ae730 View commit details
    Browse the repository at this point in the history
  8. Remove some bullet formatting

    These were left over from when I was using bullets for these paragraphs.
    bartlettroscoe committed Aug 20, 2024
    Configuration menu
    Copy the full SHA
    4f2efa2 View commit details
    Browse the repository at this point in the history
  9. Some more edits after light reading

    This reduced the length a little but up to the end of the Summary section this
    is still 1931 words (according to emacs 'count-words').
    bartlettroscoe committed Aug 20, 2024
    Configuration menu
    Copy the full SHA
    8f7c4f6 View commit details
    Browse the repository at this point in the history

Commits on Aug 22, 2024

  1. Add missing references

    All of the references should be complete now
    bartlettroscoe committed Aug 22, 2024
    Configuration menu
    Copy the full SHA
    3c52a6d View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    d121ef2 View commit details
    Browse the repository at this point in the history

Commits on Aug 26, 2024

  1. Add bullets for usage of more tools, update references

    I added mentions of code formatters and other tools like static analyzers and
    runtime memory checkers, as suggested by @ksbeattie.
    
    I also changed the reference from the book chapter "Testing of Scientific
    Software: Impacts on Research Credibility, Development Productivity,
    Maturation, and Sustainability" to shorter articles on the bssw.io site
    itself.  (We should likely reference that book chapter in those other bssw.io
    articles.)
    
    I also added another reference related to testing and had to shift all of the
    latter references.  (I could not use wikize-refs.py to do this because of the
    off-by-one issue.)
    bartlettroscoe committed Aug 26, 2024
    Configuration menu
    Copy the full SHA
    d21f5b6 View commit details
    Browse the repository at this point in the history
  2. Update info on software licenses

    Added some more text as suggested in review by @ksbeattie.
    
    I also added a reference for more info on picking an open-source software
    license.
    bartlettroscoe committed Aug 26, 2024
    Configuration menu
    Copy the full SHA
    e7d2750 View commit details
    Browse the repository at this point in the history
  3. Update text about core domain model documentation

    Improving this text was suggested by @ksbeattie in his review.
    bartlettroscoe committed Aug 26, 2024
    Configuration menu
    Copy the full SHA
    ed72a82 View commit details
    Browse the repository at this point in the history

Commits on Aug 31, 2024

  1. Slated for September 2024 publication

    Just need to fill in the day on Sept this gets published
    bartlettroscoe authored Aug 31, 2024
    Configuration menu
    Copy the full SHA
    ddbed24 View commit details
    Browse the repository at this point in the history

Commits on Sep 1, 2024

  1. More edits

    I noticed a few things after letting this sit for several days, including a
    few typos that Grammarly.com missed.
    bartlettroscoe committed Sep 1, 2024
    Configuration menu
    Copy the full SHA
    9285e5d View commit details
    Browse the repository at this point in the history

Commits on Sep 26, 2024

  1. Configuration menu
    Copy the full SHA
    d338190 View commit details
    Browse the repository at this point in the history
  2. Update filename

    bernhold committed Sep 26, 2024
    Configuration menu
    Copy the full SHA
    a7cafa2 View commit details
    Browse the repository at this point in the history
  3. Try image as hero

    bernhold committed Sep 26, 2024
    Configuration menu
    Copy the full SHA
    9425981 View commit details
    Browse the repository at this point in the history
  4. Configuration menu
    Copy the full SHA
    7bd1138 View commit details
    Browse the repository at this point in the history

Commits on Sep 27, 2024

  1. Configuration menu
    Copy the full SHA
    2791eac View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    bbef788 View commit details
    Browse the repository at this point in the history