<div dir="ltr"><div dir="ltr"><div class="gmail_default" style="font-size:small">Some thoughts/history on the IBPSA-USA BEMBook Wiki, one of the wikis...<br></div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">As Nick noted, this Wiki was not intended to replace email lists. The thinking was that there could be a 3-level hierarchy of 1) email lists/Unmethours, 2) the Wiki, and 3) BEM Library. Issues that were frequently discussed on the email lists could be captured in the crowd-sourced Wiki, and then some of those topics could be formalized in a curated library (<a href="https://www.bemlibrary.com/">https://www.bemlibrary.com/</a>) </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">Here's the link to the Wiki: <a href="http://bembook.ibpsa.us">bembook.ibpsa.us</a>. It has not been maintained for several years now. At the time, there was an editorial committee of IBPSA-USA members who reviewed contributions. Prior to setting up the wiki, the IBPSA-USA Education Committee developed an outline called the BEMBook Body of Knowledge, which was a list of topics they thought energy modelers should know about. That list forms the contents page of the wiki: <a href="https://bembook.ibpsa.us/index.php?title=Knowledge_Area_Table_of_Contents#practitionersbemoverview">https://bembook.ibpsa.us/index.php?title=Knowledge_Area_Table_of_Contents#practitionersbemoverview</a>. </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">I think there were a few problems with the idea and implementation of the wiki, but one of the main problems was the idea of publishing an outline in which most of the topics had no content. There is some useful content, but most of the links lead to empty pages, making navigation frustrating. </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">It was also tough to get good contributions. Some of the current content was written by people provided with modest honorariums to kick-start the process. Other pages were written by students as a condition of receiving an IBPSA conference travel scholarship. </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">There was also a bit of a learning curve to creating pages in the Wiki, which was a barrier to people adding content. </div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">Regarding the future, I think that a Wiki could be useful as a place for commonly used reference information to reside. A few things that come to mind are tables of material thermal data, performance curves for generic HVAC equipment, and typical operation schedules. Each of us may have our own go-to reference sources that we've identified over time. Perhaps we can share via a Wiki. Perhaps folks have better ideas?</div><div class="gmail_default" style="font-size:small"><br></div><div class="gmail_default" style="font-size:small">-Erik<br></div><div class="gmail_default" style="font-size:small"><br></div><div><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><b>Erik Kolderup, PE, LEED AP</b><div><a href="mailto:erik@kolderupconsulting.com" target="_blank">erik@kolderupconsulting.com</a><span style="color:rgb(153,153,153)"> | 415.531.5198 | </span><a href="http://www.kolderupconsulting.com" target="_blank">www.kolderupconsulting.com</a><span style="color:rgb(153,153,153)"> </span><br></div></div></div></div></div><br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">From: Nicholas Caton <<a href="mailto:Nicholas.Caton@se.com" target="_blank">Nicholas.Caton@se.com</a>><br>To: Anthony Hardman <<a href="mailto:anthony@greenengineer.com" target="_blank">anthony@greenengineer.com</a>>, Jason Glazer <<a href="mailto:jglazer@gard.com" target="_blank">jglazer@gard.com</a>>, "<a href="mailto:bldg-sim@onebuilding.org" target="_blank">bldg-sim@onebuilding.org</a>" <<a href="mailto:bldg-sim@onebuilding.org" target="_blank">bldg-sim@onebuilding.org</a>>, "<a href="mailto:equest-users@onebuilding.org" target="_blank">equest-users@onebuilding.org</a>" <<a href="mailto:equest-users@onebuilding.org" target="_blank">equest-users@onebuilding.org</a>><br>Cc: <br>Bcc: <br>Date: Fri, 11 Dec 2020 08:47:01 +0000<br>Subject: Re: [Bldg-sim] [Equest-users] <span class="gmail_default" style="font-size:small"></span>Should <a href="http://onebuilding.org" rel="noreferrer" target="_blank">onebuilding.org</a> mailing lists transition to Discourse?<br>
<div lang="EN-US">
<div class="gmail-m_-5181274691121020525WordSection1">
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif">I was personally involved with that “wiki” effort, and I am glad you reminded me Anthony. “Lessons learned” with that experience may be helpful to collect for Jason while
considering options for this transition, if anyone else has any memories from that experiment.
<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif">I recall (years later, mind) that the wiki was not intended to
<i>replace</i>, but rather to <i>augment/supplement</i> the mailing lists. The function of the wiki was to create a better place to archive/publish specific sorts of threads/content involving lots of imagery. Icing on the cake would have been the capability
to allow for collaborative contributions/editing/cross-linking/tagging, so that these articles/guides could benefit from many perspectives and grow to become a more useful/accessible archive of information over time.
<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif">At that time, I was a little more active in generating step by step guides (that I would later reference and re-send into the lists as topics resurfaced) with lots of deliberate
text formatting (color, indents, bullets, etc.) & imagery to help others pick up on a procedure or process/feature. A shortcoming of the mailing list archives (then and now) is that text formatting typically ends up totally stripped, and images would be un-inserted
and retained (if at all) as a series of cryptically named attachments instead of in-line with the text, as originally composed. The wiki looked like a worthy experiment to circumvent that set of archival issues, and better capture that sort of material for
easier access and retention.<u></u><u></u></span></p>
<p class="gmail-m_-5181274691121020525MsoListParagraph"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif">The wiki effort kinda fizzled in large part (I think) because a wiki-based platform requires of the target audience/community: (1) a small but meaningful increase in effort/time
to access/search for information, relative to the fully automated mailing list option that brings the content to you, and (2) for contributors, a LOT more time/effort (relative to emails) to contribute and deal with formatting/tagging/etc. A minor contributing
factor may have also been “contributor fragmentation” as around the same time period IBPSA was trying to launch a wiki effort with similar goals (I do not recall exactly what extent these efforts overlapped on a timeline). Either initiative might have seen
a lot more immediate growth/success all the involved contributing parties were consolidated into one effort.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif">I think a wiki may remain an ideal format for something like the doe-2 reference/engineering manual, or similar large bodies of relatively static work that could benefit from
infrequent & disparate (but peer-reviewed) edits/additions from time to time.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif">As it stands, we can all recognize active contribution/participation on the mailings lists remains a high hurdle for the community at large. I think the main hurdles preventing
more active contribution from the community include:<u></u><u></u></span></p>
<ul style="margin-top:0in" type="disc">
<li class="gmail-m_-5181274691121020525MsoListParagraph" style="margin-left:0in"><span style="font-size:11pt;font-family:Calibri,sans-serif">Participation takes time/effort out of the day. It’s hard for most with jobs including energy simulation to justify
fitting something like emailing strangers a priority. A new platform should place ease of accessibility (reading and contributions) as a penultimate priority. Access to read/contribute/search should ideally require a few clicks as possible.<u></u><u></u></span></li><li class="gmail-m_-5181274691121020525MsoListParagraph" style="margin-left:0in"><span style="font-size:11pt;font-family:Calibri,sans-serif">Ego – I think a lot of engineers suffer a mental hurdle in asking questions or responding in a public forum. It’s a
tall order in some work environments/cultures to open up and admit “I don’t know something,” especially in a public forum where your admission ends up “on the record.” As a younger engineer especially I would get really hung up on this, until I figured out
the people asking the most questions were often the smartest ones in the room. A new platform
<u>might</u> pick up a few more questions, especially from new and intermediate modelers, if it’s easy to submit queries in an anonymous fashion?<u></u><u></u></span></li><li class="gmail-m_-5181274691121020525MsoListParagraph" style="margin-left:0in"><span style="font-size:11pt;font-family:Calibri,sans-serif">Propriety – It can be hard to ask a question sometimes (and especially attach a model) when the nature of the post/question
can result in a clear line of identification to an active project, customer, or company. The same concerns can make it difficult to share a working example/solution when you see someone ask for something at your fingertips. We all want to be good stewards
of potentially sensitive information. It would be neat if a new platform could offer solutions to make it easier to ask questions anonymously, perhaps someday including scripts and/or guides to “anonymize” project files to make it easier to upload with confidence.<u></u><u></u></span></li></ul>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif">~Nick<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
<div>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Arial,sans-serif;color:rgb(58,122,70)"><img width="624" height="8" style="width: 6.5in; height: 0.0833in;" id="gmail-m_-5181274691121020525Picture_x0020_1" src="cid:17662b616734ce8e91"></span><span style="font-size:10.5pt;font-family:Calibri,sans-serif"><u></u><u></u></span></p>
<table border="0" cellspacing="0" cellpadding="0" width="624" style="width:6.5in;border-collapse:collapse">
<tbody>
<tr style="height:11.25pt">
<td width="303" colspan="4" style="width:227.25pt;padding:0in 0in 0in 0.05in;height:11.25pt">
<p class="MsoNormal"><b><span style="font-size:11pt;font-family:Arial,sans-serif;color:rgb(58,122,70)">Nick Caton, P.E. (US), BEMP<u></u><u></u></span></b></p>
</td>
<td width="321" colspan="3" style="width:240.75pt;padding:0in;height:11.25pt">
<p class="MsoNormal" align="right" style="text-align:right"><b><span lang="JA" style="font-size:11pt;font-family:"Yu Gothic",sans-serif;color:rgb(58,122,70)">ニック</span></b><b><span lang="JA" style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(58,122,70)">
</span></b><b><span lang="JA" style="font-size:11pt;font-family:"Yu Gothic",sans-serif;color:rgb(58,122,70)">ケートン</span></b><b><span style="font-size:11pt;font-family:Arial,sans-serif;color:rgb(58,122,70)">, P.E. (US), BEMP</span></b><span style="font-size:9pt;font-family:Calibri,sans-serif;color:rgb(98,100,105)"><u></u><u></u></span></p>
</td>
</tr>
<tr style="height:0.7in">
<td width="12" valign="top" style="width:9pt;padding:0in 0in 0in 0.05in;height:0.7in">
</td>
<td width="216" valign="top" style="width:2.25in;padding:0in;height:0.7in">
<p class="MsoNormal" style="line-height:150%"><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(98,100,105)">Senior Energy Engineer</span><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(31,73,125)"><br>
</span><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(98,100,105)">Energy Manager, Yokota Airbase
<u></u><u></u></span></p>
<p class="MsoNormal" style="line-height:150%"><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(98,100,105)">ESS - Energy & Sustainability Services</span><span style="font-size:11pt;line-height:150%;font-family:Calibri,sans-serif"><u></u><u></u></span></p>
</td>
<td width="42" valign="top" style="width:31.5pt;padding:0in 0in 0in 0.05in;height:0.7in">
<p class="MsoNormal" style="line-height:150%"><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(87,176,105)">M JP</span><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(31,73,125)"><br>
</span><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(87,176,105)">M US</span><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(31,73,125)"><br>
</span><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(87,176,105)">Email</span><span style="font-size:9pt;line-height:150%;font-family:Calibri,sans-serif;color:rgb(31,73,125)">
</span><span style="font-size:11pt;line-height:150%;font-family:Calibri,sans-serif"><u></u><u></u></span></p>
</td>
<td width="138" colspan="2" valign="top" style="width:103.5pt;padding:0in 0in 0in 0.05in;height:0.7in">
<p class="MsoNormal" style="line-height:150%"><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(98,100,105)">+81 . 070 . 3366 . 3317</span><span style="font-size:11pt;line-height:150%;font-family:Calibri,sans-serif"><u></u><u></u></span></p>
<p class="MsoNormal" style="line-height:150%"><span style="font-size:9pt;line-height:150%;font-family:Arial,sans-serif;color:rgb(98,100,105)">+1 . 785 . 410 . 3317</span><span style="font-size:11pt;line-height:150%;font-family:Calibri,sans-serif"><u></u><u></u></span></p>
<p class="MsoNormal" style="line-height:150%"><span style="font-size:11pt;line-height:150%;font-family:Calibri,sans-serif"><a href="mailto:nicholas.caton@se.com" target="_blank"><span style="font-size:9pt;line-height:150%;color:rgb(5,99,193)">nicholas.caton@se.com</span></a><u></u><u></u></span></p>
</td>
<td width="204" valign="top" style="width:153pt;padding:0in 0in 0in 0.05in;height:0.7in">
<p class="MsoNormal" align="right" style="text-align:right"><span lang="JA" style="font-size:9pt;font-family:"Yu Gothic",sans-serif;color:rgb(98,100,105)">シニアエネルギーエンジニア</span><span style="font-size:9pt;font-family:Arial,sans-serif;color:rgb(98,100,105)"><br>
</span><span lang="JA" style="font-size:9pt;font-family:"Yu Gothic",sans-serif;color:rgb(98,100,105)">横田基地エネルギーマネージャー</span><span style="font-size:9pt;font-family:Arial,sans-serif;color:rgb(98,100,105)"><br>
ESS - </span><span lang="JA" style="font-size:9pt;font-family:"Yu Gothic",sans-serif;color:rgb(98,100,105)">エナジー持続可能性サービス</span><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u><u></u></span></p>
</td>
<td width="12" valign="top" style="width:9pt;padding:0in;height:0.7in">
<p class="MsoNormal" align="right" style="text-align:right"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> <u></u></span></p>
</td>
</tr>
<tr style="height:23.4pt">
<td width="303" colspan="4" style="width:227.25pt;padding:0in 0in 0in 0.05in;height:23.4pt">
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(58,122,70)"><img border="0" width="162" height="41" style="width: 1.6875in; height: 0.427in;" id="gmail-m_-5181274691121020525image011.png_x0040_01D6B128.239DA330" src="cid:17662b616745b16b22"></span><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u><u></u></span></p>
</td>
<td width="321" colspan="3" style="width:240.75pt;padding:0in;height:23.4pt">
<p class="MsoNormal" align="right" style="text-align:right"><span style="font-size:11pt;font-family:Calibri,sans-serif;color:rgb(58,122,70)"><img border="0" width="240" height="45" style="width: 2.5in; height: 0.4687in;" id="gmail-m_-5181274691121020525image012.png_x0040_01D6B128.239DA330" src="cid:17662b61674692e333"></span><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u><u></u></span></p>
</td>
</tr>
<tr height="0">
<td width="12" style="border:none"></td>
<td width="216" style="border:none"></td>
<td width="42" style="border:none"></td>
<td width="33" style="border:none"></td>
<td width="105" style="border:none"></td>
<td width="204" style="border:none"></td>
<td width="12" style="border:none"></td>
</tr>
</tbody>
</table>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"> </span><span style="font-size:11pt;font-family:Arial,sans-serif;color:rgb(58,122,70)"><img border="0" width="624" height="8" style="width: 6.5in; height: 0.0833in;" id="gmail-m_-5181274691121020525image010.jpg_x0040_01D6B128.239DA330" src="cid:17662b616734ce8e91"></span><span style="font-size:10.5pt;font-family:"Yu Gothic",sans-serif"><u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11pt;font-family:Calibri,sans-serif"><u></u> </span></p></div></div></div>
</blockquote></div></div>