Update Blog “help-us-prioritize-features-for-future-releases-of-chapel”

Author: choukden

content/blog/help-us-prioritize-features-for-future-releases-of-chapel.md

@@ -7,6 +7,14 @@ disable: false
 tags:
   - Chapel
 ---
+<style>
+li {
+   font-size: 27px;
+   line-height: 33px;
+   max-width: none;
+}
+</style>
+
 In a [recent blog post](https://chapel-lang.org/blog/posts/announcing-chapel-1.32/), the Chapel team gave a preview of Chapel 1.32, the release candidate for the official 2.0 version which will declare a core subset of the language and library features as "stable". These features are ones that we intend to support in their current form going forward, such that code relying on them will not break across releases.
 
 With this candidate release available, we thought now would be a good time to get a sense for what remaining currently unstable features are important to our user base, so that we can better prioritize what to stabilize next.  To do so, we've created a Chapel program ([available here](https://github.com/chapel-lang/chapel/blob/main/tools/unstableWarningAnonymizer/unstableAnonScript.chpl)) that will summarize the unstable warnings in your key programs. This summary will not include any identifying details like module or variable names, so even if your source code is not intended for public eyes, you should be able to send us the result of running this script without worry.
@@ -17,66 +25,56 @@ Here's how to use this script:
 
 1. Compile the program linked above like you would any normal Chapel program. This should create an executable named 'unstableAnonScript'. For example:
 
-````markdown
+```markdown
+chpl unstableAnonScript.chpl
 ```
- > chpl unstableAnonScript.chpl
- ```
-````
 
-1. Compile and run your program as you would normally, with the addition of the compilation flag `--warn-unstable` (which will cause any use of unstable features to trigger a warning), and save the full output into a file.  
+2. Compile and run your program as you would normally, with the addition of the compilation flag `--warn-unstable` (which will cause any use of unstable features to trigger a warning), and save the full output into a file.  
 
-````markdown
+```markdown
+chpl --warn-unstable myProgram.chpl >myUnstableOutput.txt 2>&1  
+./myProgram >>myUnstableOutput.txt 2>&1
 ```
- > chpl --warn-unstable myProgram.chpl >myUnstableOutput.txt 2>&1  > ./myProgram >>myUnstableOutput.txt 2>&1
- ```
-````
 
-1. After these commands, `myUnstableOutput.txt` (or whatever you've named it) should contain any unstable warnings you may trigger in your code, as well as any other potential output that occurs when compiling and running your program.
+After these commands, `myUnstableOutput.txt` (or whatever you've named it) should contain any unstable warnings you may trigger in your code, as well as any other potential output that occurs when compiling and running your program.
 
-Run the built script over your output file.  For our convenience, it would be helpful to run with the `--csv` and `--sorted` flags, or `-c` and `-d` if you want to use the shorter version of those flags.
+3. Run the built script over your output file.  For our convenience, it would be helpful to run with the `--csv` and `--sorted` flags, or `-c` and `-d` if you want to use the shorter version of those flags.
 
-````markdown
-```
-> ./unstableAnonScript --csv --sorted --inputFiles myUnstableOutput.txt --outputFile mySummary.csv
+```markdown
+./unstableAnonScript --csv --sorted --inputFiles myUnstableOutput.txt --outputFile mySummary.csv
 ```
 
 or
 
+```markdown
+./unstableAnonScript -c -d -i myUnstableOutput.txt -o mySummary.csv
 ```
- > ./unstableAnonScript -c -d -i myUnstableOutput.txt -o mySummary.csv
- ```
- 
-````
+
 
 Note that `--inputFiles`/`-i` can take multiple files, so if you have multiple chapel programs you'd like to share the results for, you can combine the results together by specifying the unstable warnings from all of those programs at the same time:
 
-````markdown
+```markdown
+./unstableAnonScript -c  -d -n -i myUnstableOutput1.txt myUnstableOutput2.txt myUnstableOutput3.txt -o mySummary.csv
 ```
- > ./unstableAnonScript -c  -d -n -i myUnstableOutput1.txt myUnstableOutput2.txt myUnstableOutput3.txt -o mySummary.csv
- ```
-````
 
 After any of these commands, `mySummary.csv` (or whatever you've named
 it) should contain a comma-separated list of the unstable warnings generated by your program(s) and their counts, sorted from most common to least.  There should be no identifying information in this file, so at this point, it should be safe to send the file to us.
 
 You could also additionally run with the `--numFiles` flag (`-n` for short), which will include the number of different files where each unstable warning was generated:
 
-````markdown
-```
-> ./unstableAnonScript --csv --sorted --numFiles --inputFiles myUnstableOutput.txt --outputFile mySummary.csv
+```markdown
+./unstableAnonScript --csv --sorted --numFiles --inputFiles myUnstableOutput.txt --outputFile mySummary.csv
 ```
 
 Or
 
+```markdown
+./unstableAnonScript -c -d -n -i myUnstableOutput.txt -o mySummary.csv
 ```
- > ./unstableAnonScript -c -d -n -i myUnstableOutput.txt -o mySummary.csv
- ```
- 
-````
 
 This information would be helpful for our metrics, but is not essential.
 
-Please send your resulting file to chapel[email protected]. If you would like to send it to just the Chapel team at HPE, you can either send it to the [Chapel team at Discourse](https://chapel.discourse.group/c/info/16) or to [Lydia Duncan at Discourse ](https://chapel.discourse.group/u/lydia)directly. Note that if you do not already have a Discourse account, you may be asked to create one to send it.
+Please send your resulting file to [chapel users mailing list on Discourse](https://chapel.discourse.group/c/users/6). If you would like to send it to just the Chapel team at HPE, you can either send it to the [[email protected]](mailto:chapel+info@discoursemail.com) or to [Lydia Duncan at Discourse](https://chapel.discourse.group/u/lydia) directly. Note that if you do not already have a Discourse account, you may be asked to create one to send it.
 
 If you have any questions or concerns about this, please don't hesitate to voice them.