The Public Lab Blog


stories from the Public Lab community

About the blog | Research | Methods



Q&A enables automated FAQ

by liz | about 3 years ago | 0 | 1

Asking and answering questions is at the very heart of Public Lab. It's how we get started, it's how we make progress, it's how we get to know each other and our environmental concerns. Dedicated readers will recognize that some "getting started" exchanges have been repeated countless times on the mailing lists. (PS To those of you who are high volume question answerers -- everyone is endlessly grateful for your responses!) While it's critical that that questions from newcomers, however repetitive, will always be welcome, generating a Frequently Asked Questions (FAQ) grid will lower the barrier to exchanging information.


There are two parts to the new automated FAQ system:

1) The new Question and Answer system that @Ananyo2012 built into the plots2 codebase this summer is up and running.
See it here: https://publiclab.org/questions And read more about it here: https://publiclab.org/wiki/public-lab-q-and-a

Screen_Shot_2016-09-07_at_12.18.18_PM.png

2) The FAQ Grid is a variation of the Activity Grid insofar as it's also generated by a powertag, and sorted by Likes.

FAQs will be on every "top-level" research page, see it here https://publiclab.org/wiki/spectrometry#Frequently+Asked+Questions

Screen_Shot_2016-09-07_at_12.14.07_PM.png

You can add an automated FAQ grid to any wiki page by using this code:

the title:
## Frequently Asked Questions

the button where people can ask a new question:

<a class="btn btn-primary" href="/post?tags=question:spectrometry&template=question">Ask a question about spectrometry</a>

the grid itself:

[notes:question:spectrometry]

Screen_Shot_2016-09-07_at_12.15.06_PM.png


As @mathew reported back from Write The Docs, pruning an automated system of FAQs is superior to curating a manual one. Further, linking product support directly to documentation is so important that the Kits Initiative will move their knowledge base onto the Q&A, and will interact with customers using Q&A.

Early adopters on method specific mailing lists might consider subscribing to the relavant question:foo tag on the website. (pssst this is the start of a medium term plan to move all mailing list interactions onto the website). For instance, spectrometry list members might want to subscribe here: https://publiclab.org/tag/question:spectrometry

Screen_Shot_2016-09-07_at_12.17.26_PM.png

Please write in with ideas and new suggestions! What do you think?

Read more » Subscribe

  • community blog with:warren with:gretchengehrke


    Check out these Activity Grids

    by liz | about 3 years ago | 9 | 8

    The sheer number of posts on publiclab.org by contributors from all over the world about 1) how to build tools better, and 2) how to use them for making environmental observations is breathtaking, and at times, boggling. As Public Lab has grown, so much content has been generated that it has become unnecessarily difficult to know what the "latest and greatest" version is, what the next development challenges are, or simply where newcomers should begin.

    In the past couple weeks, staff have begun "gardening" on PublicLab.org and writing some new web features.

    Organizing research areas

    People on the spectroscopy and near-infrared lists have been discussing how to better present the overall research areas to make it easier to get involved. For each of those two research areas, we made a new top-level page. See them at spectrometry and multispectral-imaging. On those new pages, we constructed a couple tables -- the main table organizes relevant research notes into a "ladder" of activities others can replicate. There are columns to describe what type of activity it is, the status of its documentation, and how many people have replicated it.

    Screen_Shot_2016-08-30_at_2.35.05_PM.png

    We made a "Request A Guide" button to capture ideas about what people would like to do but don't see listed yet:

    Screen_Shot_2016-08-30_at_2.35.36_PM.png

    We also drafted two other kinds of tables, one to track upgrades (additions, modifications) that people have made to particular tools (for instance, the desktop spectrometer):

    Screen_Shot_2016-08-30_at_2.46.30_PM.png

    ...and another to hold questions related to a particular research area (for instance, spectrometry):

    Screen_Shot_2016-08-30_at_2.38.32_PM.png

    Check out this much easier, automated way to organize content into grids:

    After creating the first grids manually, WebWorkingGroup quickly created an automated way to make the grids. We created a power tag to add an Activity Grid to your wiki page with just a few characters, like this: [activities:spectrometry]:

    Screen_Shot_2016-08-30_at_2.34.00_PM.png

    This automated Activity Grid fills itself in with all research notes tagged with the key word you used. Consider the keyword "spectrometry": a grid on a wiki page created with the powertag [activities:spectrometry] will pull in all content (notes/questions) tagged with the powertag activity:spectrometry. Check it out on https://publiclab.org/wiki/sandbox, look at the tables, then click "edit" to see how the tables were generated. The tables have various columns, such as "difficulty" (like easy, moderate, or hard), which can be filled out by adding more tags on the research notes. We're working on a tagging interface to make tagging less mysterious:

    Screen_Shot_2016-09-09_at_1.25.40_PM.png

    Help kick the tires!

    These draft "Activity Grids" are ready for you to test drive! How?

    • Browse the activity grids and try out someone's activity. Responding via the button "Post your attempt to replicate this activity" will count your work as a "replication" on both the original note and in the grid.

    Screen_Shot_2016-08-30_at_2.07.38_PM.png

    • If you've previously posted an activity on publiclab.org, read through it and see what you could add/edit to make it easier for someone else to follow, then tag it so it will appear in the relevant Activity Grid.
    • Want to organize a content on a new (or existing) wiki page? add one or more of these power tags...

    Screen_Shot_2016-08-30_at_2.24.54_PM.png

    ...and to pipe content into the grid, go back to your original notes and add the powertag activity:spectrometry. To fill out the columns for each activity, use the tagging interface to add additional powertags or directly type: seeks:replications difficulty:easy time:30m

    Screen_Shot_2016-08-30_at_2.52.21_PM.png

    If you want any assistance, email web@publiclab.org and we'll help you get it going!

    Read more » Subscribe

  • collaboration blog with:warren with:gretchengehrke


    Wrapping up Google Summer of Code 2016!

    by warren | about 3 years ago | 2 | 6

    We've had some tremendous work on Public Lab software this past summer through our Google-supported Google Summer of Code program, where five students and several mentors have spent innumerable hours cooking up new features and abilities both on the PublicLab website and in the independent #webjack project.

    Even just in the past month, we've seen (via Github Pulse):

    Excluding merges, 9 authors have pushed 368 commits to master. 321 files have changed and there have been 7,047 additions and 1,217 deletions.

    The program wraps up this week with many of the features having gone live over the past few weeks. Our five students have written up their work in a series of notes, which I'll link to here:

    Thanks to all of our mentors for their ongoing input and support, with special thanks to the Community Development team, @liz and @stevie. I'd also like to shout out to @david-days, as well, who put an enormous amount of work into the Advanced Search project, and in particular, whose work was just merged for the first time last week in an epic rebase of hundreds of files and thousands of lines of code.

    These projects, from including more languages on PublicLab.org to making it easier to find people and resources near you, all have helped to make Public Lab's collaborative model stronger, and we're eager to see how the new features promote the growth of our community.

    Fast paced work

    All of our students this year were extremely productive, and we had our best-ever GSoC program, beyond all doubt. The fast pace of merging (twice weekly) was exciting and really ensured that student work tracked the master branch closely, and that new changes (with corresponding tests) were quickly and consistently integrated into production code instead of drifting off and resulting in larger, more difficult merges later. Thanks to all of our students for keeping up with this fast pace (and occasionally going faster than I could!). It was great to have students who knew how to do pull requests, write and run tests, and rebase their changes to make things efficient, so we could focus on doing great work.

    Welcoming new contributors

    One of the things which really made the difference this year was the way our #new-contributors work helped to ease students' entrance into the codebase, and we've asked the students to, in turn, produce some `help-wanted` and `first-timers-only` issues to draw yet more contributors into the project:

    https://github.com/publiclab/plots2/labels/help-wanted

    Amazingly, this has worked very well, and two new contributors (carolineh101 and ykl7) have committed code in the past two weeks, directly resulting from these outreach efforts. With so many well-documented and welcoming issues, we hope this is just the beginning. See the screenshot below for just a portion of our first-timers-only posts!

    So, all in all, a fantastic summer, and thanks to all who helped out!

    Screenshot_2016-08-26_at_11.45.08_AM.png

    Read more » Subscribe

  • software gsoc web blog


    Introducing the Environmental Evidence Project, a blog series from Public Lab

    by warren | about 3 years ago | 7 | 7

    Hello everyone -- Jeff Warren and Gretchen Gehrke here, Public Lab's Research Director and Data Quality and Advocacy Manager, respectively. Over the next few months, we're hoping to share a series of posts covering different aspects of the concept of evidence. What is it evidence, what factors contribute to the importance of evidence, and how does all that relate to environment sensing?

    (Lead image: a tar ball, photo by @eustatic)

    We spend a lot of time thinking about different kinds of data and how to collect it. Well, imagine you've got some data. How does it compare to other kinds of data? How's it been used for action? How was it analyzed, stored, sent, presented?

    We have a lot of questions and we'll be talking to a number of different people, from environmental lawyers to formal scientists, regulators and activists who've gone through this and have experience with the ins and outs of evidence. We're also looking to co-author blog posts and research notes with other individuals or groups, so if you're interested, please reach out! (jeff@publiclab.org)

    You'll be able to follow this series under the tag #evidence-project, and you can sign up to get notifications here.

    23821356615_acab22d82b_k.jpg

    Suspected oil samples, kept in a cooler; photo by Scott Eustis (@eustatic)

    In particular, we're going to look at some specific types of data we're interested in, related to the use of photography as evidence: for example, timelapses of turbidity events in water, or photographs of microscopic silica. We want to research how such data has been used in the past, but also document and discuss best practices for storing, transporting, and presenting it, with an eye toward environmental outcomes.

    Topics

    Broadly, we're thinking of doing posts on some of the following topics:

    • possible outcomes, esp. legal ones: civil suit, regulation, enforcement, criminal suit, cleanup, publicity-driven withdrawal
    • legal basics: how evidence is entered, challenged, presented, and terms like deposition, discovery, and authentication
    • permitting under the Clean Water Act
    • the pathway from collection to outcomes

    Questions

    Before we kick this off, we'd like to share some of the questions that have motivated us, and ask you to chip in with your own questions -- and resources! We've already had a great opportunity to chat with Chris Nidel, who participated in an OpenHour on "proof" a few months ago, and we're eager to talk with a broad range of folks. In the comments, please list out some of the things you want to know about how environmental data can become evidence, and if possible, share a bit of background to help situate your questions.

    • Why do we hear different things from different folks on certification of methods? Some have said that they don't use data that's not collected using an EPA certified method and produced by an accredited lab, while others have indicated they'd use community collected data.
    • Is there a precedent, or best practices, from the use of security camera footage as evidence -- storage, authentication, presentation?
    • What about timelapse photography, for example, to monitor activities at an industrial site?
    • When is EPA certification NOT absolutely required? Can this be jurisdiction or law/regulation dependent?
    • What about challenging evidence from a report under a Clean Water or Clean Air Act permit?
    • What's the limit of photographic data -- has it been used for Secci disks, photos of smoke, turbidity or plumes?

    These are just a few of our many questions, but please add your own below!

    Thanks!


    We'll also be adding some of our questions into the new Q&A system which was recently added to this site. As people add questions on the topic of evidence, they'll appear here:

    Ask a question  or help answer future questions on this topic

    Ask a question about evidence

    Read more » Subscribe

  • evidence blog with:gretchengehrke evidence-project


    Regional Barnraising 2016: A Few Thoughts About Public Lab's Work

    by sarasage | about 3 years ago | 2 | 5

    Greetings From Val Verde:

    It has been a month since Public Lab has left Val Verde, and a month since a very intensive Barnraising in which we literally met in a barn with incredibly interesting, creative and dedicated people. Sharing the event with the greater Public Lab community was foremost in our minds, until we got distracted with recent events – apologies for the late report.

    Before I start, and because I plan to share this with my community, I want to answer the question that a lot of neighbors asked me: What is Public Lab and what do they do?

    Okay, so. Public Lab is a lot of things: they focus on low-cost approaches to fill data deficits; they provide a crucial platform for interested parties and stakeholders to share ideas; they communicate with communities and help to uncover and research areas of human health and industry that are not being addressed. They help to provide tools and support to enable researchers to map the world's urban population who live in unauthorized settlements, for instance.

    But what is Public Lab really do -- Without all of the language -- What do they do? In my opinion, I believe that Public Lab’s mission, the most important thing that they do, is spread this gospel:

    The most efficient way to solve a problem is to communicate.

    As a newcomer to the Public Lab community, Public Lab truly is an altruistic group of people who have a method and way of organization that works to solve problems. The regional barnraising event is another tool for Public Lab to share their innovative approach with other regions. We were very fortunate to have been able to host the event and want to thank Public Lab for the opportunity to be influenced by PL's way of thinking.

    SoilSampling.jpg

    Public Lab does something different in that they do not place primary value on the outcome, but rather the work and the process. This is a refreshing point of view when you are locked in a battle as my community is with a local polluter. The focus is always the outcome.

    If I can be allowed to be sentimental, since the Olympics are underway, successful athletes think this way. They focus on process, the moment and also employ innovation in finding ways to make their hard work take them further.

    On a less local level, if each of us learns to communicate and collaborate with others to solve very real, pressing, human issues – such as biodegradability of ocean plastics – we have a chance to make change that we desire and leave the world not only in a better place. We can also leave the world a better place not only because pollution has decreased, we can leave the world a better place because we have learned to communicate and value each other -- a foundation for global peace and understanding.

    Enough of that.

    (Stay tuned for more pictures and events from the July Regional Barnraising in Val Verde).

    Read more » Subscribe

  • landfill barnraising blog val-verde


    到中国的东江源头村使用Balloon Mapping Kit

    by karypun | about 3 years ago | 7 | 6

    Hello,我想和大家分享我在中国江西使用Balloon Mapping Kit的经历。首先呢,这里是中国江西省的东南部,寻乌县三标乡的东江源村。东江源村位于东江的源头,而东江则是珠三角东岸众多城市的水源地,如广州、深圳、香港。就是说,我家的自来水很有可能就是从这一路流到我家的水龙头呢。

    What I want to do

    那么,这是我们第一次使用Balloon Mapping Kit。除了想体验把氦气球放到天空中拍摄图片的过程,我们在这里使用Balloon Mapping Kit,还有是希望了解东江源的实时地理概况,了解村庄和附近河流的情况,帮助我们更熟悉这个村庄。

    My attempt and results

    我们在制作氦气球的过程中发现了许多可能会影响氦气球升空的因素。 第一,如何绑气球使气球的承重最少,并且保证绳结不容易松开。 首先我们选择了不易断裂的麻绳。然后我们用了一种可以活动一边绳子的打结方法,这样即使气球活动,也能减少绳子的磨损。我们尽可能的减少打结的次数,因为何珊老师说每打一个结就会使气球的整体承重增加。最后我们把11个气球分别拴在一个橡胶环上,这样能保证即使一个气球飞走了,摄像机也不会立刻下坠到地面。 第二,用什么材料的气球才能使气球不容易漏气和破裂,并且能充入更多气体。 我们用了3个大橡胶气球和8个铝膜气球,因为橡胶气球的拉伸限度大,可以在一个气球中充入大量的氦气,尽可能使气球的浮力更大,而铝膜气球不容易漏气和破裂。

    1823306375.jpg

    第三,选择什么位置来放气球,让摄像机能拍到大部分的村庄同时不会被电线或树枝干扰。 我们首先找到一个远离电线和树枝,靠近河流的地方,因为希望能拍摄一下河流的大概流向。然后第二次我们找到一个靠近村民家的地方,希望能拍摄村落的大概分布情况。

    1715572705.jpg

    345429012.jpg

    最后,可能是因为气球在升空的过程中一直在漏气,所以只上升到大概600米的高度。 不过我们也拍摄到我们所需要的图像了,哈哈给大家看看我们制作的MapKnitter:

    906305355.jpg

    然后呢,从这次拍摄和制作地图过程中,我们发现了原来位于村子旁的这条河流在2015年的时候还是一条土河,河流是在今年才变成我们现在所看到的样子。 Google Earth上显示的地图:

    我们所拍摄到的河流:

    1624676511.jpg

    其实,源头区的人们正在逐步改变他们祖祖辈辈一直以来的生活方式。过去,这里的人们靠山吃山,但近年来,因环保政策的实施,为了保障珠江三角洲居民和香港同胞能喝上安全的饮用水,东江源村的传统让步于水源保护。村民们开始改变自己以往的耕作方式,政府和村委会也向村民宣传环保,保护水源的意识,甚至有的村民已经开始经济转型,从其他产业来增加自己的收入来源。 我们希望,未来的某一天,东江源村这个地方能做到人与环境的和谐统一。

    Questions and next steps

    那么,在使用Balloon Mapping Kit的过程中,我们觉得最限制氦气球升空的因素就是,气球的拉伸限度不够大,无法在同样的重量下充入更多的氦气,还有就是气球比较容易漏气,这也是我们无法把气球升到更高的原因。

    Why I'm interested

    可能PublicLab和Balloon Mapping Kit在中国只有极少数人知道。所以我们希望能通过这次航拍来向身边的人宣传PublicLab和气球航拍,让大家都可以自主的了解自己的生活环境。并且,我们希望能通过这次实践来了解如何使用Balloon Mapping Kit。

    这是我们所有人的合照:

    808692365.jpg

    1992144294.jpg

    Read more » Subscribe

  • blog barnstar:basic first-time-post