Contribute to Open Source. Search issue labels to find the right project for you!

spec: small issues with slice type definition


I have two small issues with the definition of a slice type:

A slice, once initialized, is always associated with an underlying array that holds its elements.

This is not true of a nil slice. Since this refers to initialization, it is talking about variables and not values. Changing this to “A non-nil slice value…” would probably fix this, since initialization of slices is already well-defined elsewhere.

The capacity is a measure of that extent: it is the sum of the length of the slice and the length of the array beyond the slice; …

This is not true of a slice whose capacity has been explicitly reduced. This is easily fixed by removing the explicit definition of capacity here and then, in the section on slice expressions, explicitly saying that the capacity of the slice a[low:high] is cap(a) - low. This also solves an ambiguity in that the capacity of a[:] is not actually defined and, based on the quoted statement, could be argued to extend the capacity back of up that of the underlying array if a is a limited-capacity slice.

Updated 30/04/2017 15:52

The Road to JSDocs


We are moving documentation to JSDoc3. This means the site will be generated through JSDoc annotations and markdown docs will also be generated through JSDoc annotations from the same source. Since JSDoc allows us to make tutorials we will add those as well.

  • [ ] Set up JSDoc task and configuration (should generate a site and markdown docs)
  • [ ] Set up transition folders while we catch up JSDoc annotations to existing markdown docs (new_docs for markdown and new_site for generated html site)
  • [ ] Move all existing API documentation to JSDoc annotations
  • [ ] Add testing + recipes tutorials (copy from existing site)
  • [ ] Theme docs to look like our current site
  • [ ] Add a custom front page (copy from existing site)
  • [ ] Once JSDocs are caught up to current documentation overwrite docs with new_docs and site with new_site
  • [ ] Figure out versioning of docs. (probably a task to write to subfolders of docs and site
  • [ ] Add examples as tutorials (examples may be in a different repo by this time)
    • [ ] Update instructions to run any of the examples.
    • [ ] Explain why these examples exist (what feature are they highlighting?)
    • [ ] Include possible problems running the examples (eg. if port :3000 is in use an error is thrown)
    • [ ] Update both the /examples and each example’s
Updated 30/04/2017 15:07

COAL, coal, PyCOAL, Pycoal, pycoal


Currently all five variations “COAL”, “coal”, “PyCOAL”, “Pycoal”, and “pycoal” are in use in our code and documentation: `` $ grep -i 'pycoal' * grep: docs: Is a directory grep: examples: Is a directory grep: pycoal: Is a directory pycoal[![license](](ht tp://[![Build Status](]( ne-coal/pycoal)[![PyPI](]( i/pycoal)[![Launch Binder](]( repo/capstone-coal/pycoal)[![Documentation](](http://pycoal.readthedocs. io/en/latest/)[![Requirements Status](](htt ps://[![Code Health](](https: //**pycoal provides a suite of algorithms (written in Python) to identify, classify, characterize, and quantif y (by reporting a number of key metrics) the direct and indirect impacts of MTM and related destructive surface mining activities across the continental U.S.A (and further afield)**. install pycoal install -c conda-forge pycoal clone && cd pycoal[![Launch Binder](]( repo/capstone-coal/pycoal) the [examples directory]( you can find sever al Jupyter notebooks with specific applications of coal. You can launch a cloud Jupyter server using binder to edit th e notebooks without installing anything. Try it out! documentation can be found at however you can also build documentation m anually. uses the popular [nose]( testing framework. Tests c an be run as follows = '' = 'pycoal' = 'pycoal.tests' = '' $ grep -Ri 'pycoal' docs/source/* | grep -vi _build docs/source/, os.path.abspath('../../pycoal')) docs/source/ = u'pycoal' docs/source/environment.rst:.. autoclass:: pycoal.environment.EnvironmentalCorrelation docs/source/index.rst:Welcome to pycoal's documentation! docs/source/introduction.rst:What is Pycoal? docs/source/introduction.rst:pycoal provides a suite of algorithms (written in Python) to identify, classify, characte rize, and quantify (by reporting a number of key metrics) the direct and indirect impacts of MTM and related destructi ve surface mining activities across the continental U.S.A (and further afield). docs/source/introduction.rst:More information on COAL can be found at theproject website <https://capstone-coal.gith>_ as well as thecourse documents directory _. docs/source/mineral.rst:.. autoclass:: pycoal.mineral.MineralClassification docs/source/mineral.rst:.. autoclass:: pycoal.mineral.AsterConversion docs/source/mining.rst:.. autoclass:: pycoal.mining.MiningClassification docs/source/quickstart.rst:In theexamples directory you can find several Jupyter notebooks with specific applications of coal. You can launch a cloud Jupyter server usin g binder to edit the notebooks without installing anything.Try it out <

_! $ grep -Ri 'pycoal' pycoal/ | grep -v ^Binary pycoal/ pycoal pycoal/ Classify mines or other features in a PyCOAL mineral classified image by pycoal/ 'description': 'PyCOAL '+pycoal.version+' mining classified image.', pycoal/tests/ pycoal pycoal/tests/ pycoal.mining pycoal/tests/ mc = pycoal.mining.MiningClassification() pycoal/tests/ os.chdir('pycoal/tests') pycoal/tests/images/ang20150422t163638_corr_v1e_img_987_654_rgb.hdr: PyCOAL 0.2 three-band RGB image.} pycoal/tests/images/ang20150420t182050_corr_v1e_img_class_mining_cut_NHDFlowline_corr.hdr: PyCOAL 0.5-dev environment al correlation image.} pycoal/tests/images/ang20150422t163638_corr_v1e_img_4000-4010_550-560_class.hdr: PyCOAL 0.2 mineral classified image. } pycoal/tests/images/ang20150420t182808_corr_v1e_img_class_mining_4200-4210_70-80.hdr: PyCOAL 0.2 mining classified im age.} pycoal/tests/images/ang20150420t182808_corr_v1e_img_class_4200-4210_70-80.hdr: PyCOAL 0.2 mineral classified image.} pycoal/tests/images/ang20150420t182050_corr_v1e_img_class_mining_cut.hdr:/media/study/OSU/spring17/cs463/coal/pycoal/t ests/images/ang20150420t182050_corr_v1e_img_class_mining_cut.img} pycoal/tests/images/f080702t01p00r08rdn_c_sc01_ort_img_123_456_rgb.hdr: PyCOAL 0.2 three-band RGB image.} pycoal/tests/images/ang20140912t192359_corr_v1c_img_2580-2590_540-550_class.hdr: PyCOAL 0.2 mineral classified image. } pycoal/tests/images/ang20140912t192359_corr_v1c_img_400-410_10-20_class.hdr: PyCOAL 0.2 mineral classified image.} pycoal/tests/images/ang20140912t192359_corr_v1c_img_400-410_10-20_rgb.hdr: PyCOAL 0.3-dev three-band RGB image.} pycoal/tests/ pycoal pycoal/tests/ pycoal import mineral pycoal/tests/ pycoal import mining pycoal/tests/ assert actual.metadata.get(u'description') == 'PyCOAL '+pycoal.version+' mineral classified image.' pycoal/tests/ pycoal pycoal/tests/ pycoal pycoal/tests/ pycoal import environment pycoal/tests/ assert actual.metadata.get('description') == 'PyCOAL '+pycoal.version+' environme ntal correlation image.' pycoal/ pycoal pycoal/ ``pycoal.mineral.AsterConversion.convert()``. pycoal/ 'description': 'PyCOAL '+pycoal.version+' mineral classified image.', pycoal/ pycoal.mineral.MineralClassification.filterClasses(classifiedFilename) pycoal/ rgbMetadata['description'] = 'PyCOAL '+pycoal.version+' three-band RGB image.' pycoal/ pycoal pycoal/ 'description': 'PyCOAL '+pycoal.version+' environmental correlation image.', pycoal/ Create an empty copy of a PyCOAL classified image with the same size. ``` And on the website: ``` $ grep -Ri pycoal . | grep -v _site ./_includes/header.html: <a class="github-fork-ribbon" href="" title="Fork m e on GitHub">Fork me on GitHub</a> ./index.html: <p>Read the <a href="docs">documentation</a> to learn how to install and use the Python COAL pa ckage <a class="external" href=""><code>pycoal</code></a>.</p> ./index.html: <li>Browse the <a class="external" href="">API refere nce</a> for detailed class and method documentation,</li> ./index.html: <li>View development documentation on our <a class="external" href=" ne-coal/pycoal/wiki">wiki</a>.</li> ./docs.html:<p>This section will describe how to install the Python COAL package <a class="external" href="https://pyp"><code>pycoal</code></a> from the Python Package Index (PyPI).</p> ./docs.html:<p>This section will demonstrate basic usage of the Python COAL library and link to the detailed <a class= "external" href="">API reference</a>.</p> ./docs.html:<p>This section will discuss how to contribute to the project through our <a class="external" href="https: //">GitHub Organization</a> and refer to the COAL <a class="external" href=" /capstone-coal/pycoal/wiki">wiki</a> for development documentation.</p> ``` This was discussed in a [previous issue]( but not resolved. A decision made was to refer to the project as "COAL" and the Python package aspycoal`. This issue could either update the code and documentation or consider additional alternatives.

Assigning initially to @lewismc to confirm naming conventions and then delegate as necessary.

Updated 30/04/2017 11:25 1 Comments

doc: enhance Github templates.


<!– How to write a good pull request?


And the contributing guide: –>


<!– Briefly describe the pull request in a few paragraphs. –>

  • suppress the mini user’s guides.
  • explain the ‘traefik bug’ command.
Updated 30/04/2017 12:44

Opening up the wiki


As an experiment, I’m opening up the wiki to lower the bar for people contributing documentation. Feel free to put whatever you want there (as long as it is related to ev3dev, obviously). I see it as a way to say “hey, look at this neat thing I figured out how to do” without having to spend the time writing up polished documentation. Let’s see what happens…

Updated 30/04/2017 05:10 3 Comments

How to copy built image to SD


From Linux: $ cat build/sun8i-h2plus-orangepi-zero.raw > /dev/$SDCARD

From Windows (?):!$


one way to check - eject it and re-insert it, see if it has a filesystem on it with “/boot” now

NOTE: We may be changing .raw to .img.

Updated 30/04/2017 10:31 1 Comments

spec: un-conflate variables and values.


The notions of variable and value, although meaningfully distinct, are often conflated in the spec. Some examples:

  1. Dynamic types are defined as a property of interface variables, but are properly a property of interface values. The definition of static type also treats elements of structs, arrays, and slices as variables (see next point).
  2. There is a definition of structured type that provides that elements of slices, arrays, and structs and like variables. Putting aside the question of whether slices have elements or not, this is not true in any case of unaddressable arrays.
  3. Pointers are defined as pointing to variables, not addressable values.
  4. Variables of interface type are capable of storing values of any compatible type, but no mention is made of interface values.
  5. “In other words, the switch expression is treated as if it were used to declare and initialize a temporary variable t without explicit type; it is that value of t against which each case expression x is tested for equality.” does not seem like it actually clarifies anything to me; rather, it is just gymnastics to work around the possibility that values don’t have a properly defined existence.

This is probably all of them, but I’m not sure.

Updated 30/04/2017 16:22 3 Comments

Add Flip Filter

Branch? 1.0
Bug fix? no
New feature? yes
BC breaks? no
Deprecations? no
Tests pass? yes
Fixed tickets #918
License MIT
Doc PR #920

This pull request adds a simple filter implementation to allow for image flipping (both along the x and y axis). Included are tests and documentation, as well as some general cleanup of the file.

The included OptionsResolver abstraction was introduced to aid in the API differences between Symfony =2.3 and >=2.7. My long-term intention is to move other filter loader implementations to using the options resolver as well; once this has been done, this abstraction can be removed in the 2.x branch where it is no longer required without affecting the method calls within filters.

Updated 30/04/2017 00:19

massive documentation normalization and restructuring


This is a large change. The whole doc package now builds as one.

  • removed the meta package formatted
  • attempted to normalize the package structures
  • added a new template with the ST branding
  • added sphinx-automodapi for API docs in all subpackages
  • updated travis build and RTD requirements (it should build there, but I haven’t tried)
  • there are still warnings from malformed docstrings in the code repositories
  • there are still warnings from sphinx doc issues like duplicate labels

Otherwise, give this a go and see if it works for people other than me :8ball: Also, give your own package a look and see if anything is glaringly wrong or missing. Feel free to make it prettier, but lets merge this first if everyone agrees and then do that?


Updated 30/04/2017 00:17

Error during the 5min tutorial of Pillar



Link to tutorial:


cyril@macbook-pro-de-larcheveque ~/M2Report> curl | bash
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  2866  100  2866    0     0   3505      0 --:--:-- --:--:-- --:--:--  3503
--2017-04-30 00:32:32--
Connecting to||:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 5665 (5.5K) [text/html]
Saving to: ‘STDOUT’

-                                            100%[=============================================================================================>]   5.53K  --.-KB/s    in 0.005s  

2017-04-30 00:32:32 (1.10 MB/s) - written to stdout [5665/5665]

Downloading the latest pharoVM:
Downloading PharoV50.sources:
Creating starter scripts pharo and pharo-ui
--2017-04-30 00:32:44--,VERSION=stable,VM=vm/lastSuccessfulBuild/artifact/
Connecting to||:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 18408064 (18M) [application/zip]
Saving to: ‘’                               100%[=============================================================================================>]  17.55M   870KB/s    in 21s     

2017-04-30 00:33:05 (867 KB/s) - ‘’ saved [18408064/18408064]

Preparing Pillar image
cyril@macbook-pro-de-larcheveque ~/M2Report> ./pillar archetype welcome
cyril@macbook-pro-de-larcheveque ~/M2Report> make book-result/welcome.html
mkdir -p ./book-result
find . -type d -path ./book-result -prune -o -wholename "*/figures" -exec cp {} --parents -r ./book-result \;
cp -r support/ ./book-result
./pillar export --to=html --outputDirectory=./book-result --outputFile=welcome.pillar welcome.pillar
MessageNotUnderstood: FileReference>>jsonWriteOn:
FileReference(Object)>>doesNotUnderstand: #jsonWriteOn:
[ :assoc | 
    ifTrue: [ aStream nextPut: $, ]
    ifFalse: [ needComma := true ].
assoc key jsonWriteOn: aStream.
aStream nextPut: $:.
assoc value jsonWriteOn: aStream ] in Dictionary>>jsonWriteOn: in Block: [ :assoc | ...
[ :each | each ifNotNil: [ aBlock value: each ] ] in Dictionary>>associationsDo: in Block: [ :each | each ifNotNil: [ aBlock value: each ] ]
[ :outStream | 
    writeOutput: (self asJson: output withConfiguration: cocoonConfiguration)
    toStream: outStream ] in PRExportPhase>>write:using: in Block: [ :outStream | ...
[ aBlock value: stream ] in FileReference(AbstractFileReference)>>writeStreamDo: in Block: [ aBlock value: stream ]
PRExportPhase class(PRPhase class)>>executeOn:
[ :input | self executeOn: input ] in PRExportPhase class(PRPhase class)>>buildPipe: in Block: [ :input | self executeOn: input ]
[ :subResult :next | next executeOn: subResult ] in LPPipeline>>executeOn: in Block: [ :subResult :next | next executeOn: subResult ]
[ :each | nextValue := binaryBlock value: nextValue value: each ] in OrderedCollection(Collection)>>inject:into: in Block: [ :each | nextValue := binaryBlock value: nextValu...etc...
[ :exporter | (configuration getConfigurationNamed: exporter) export ] in [ configuration defaultExporters
    do: [ :exporter | (configuration getConfigurationNamed: exporter) export ] ] in PRExportCommandLineHandler>>export in Block: [ :exporter | (configuration getConfigurationNamed...etc...
[ configuration defaultExporters
    do: [ :exporter | (configuration getConfigurationNamed: exporter) export ] ] in PRExportCommandLineHandler>>export in Block: [ configuration defaultExporters...
make: *** [book-result/welcome.html.json] Error 1
rm book-result/welcome.html.json
Updated 30/04/2017 08:24 2 Comments

Sometimes you don't need a JSON with id and secret but with key and secret (eg. LinkedIn)



When deploying an OAUTH for LinkedIn it didn’t work…So I started analyzing the code and noticed that the magic happens under the vendor php’s. There you’ll see it wants key instead of id. Maybe this can be mentioned under the homepage or something?

Version and provider

HybridAuth v2.0.4 Is this an issue with a provider? If yes, which one?


just add the key value as id/secret JSON format

Updated 30/04/2017 06:34 2 Comments

Implement Search Example and Demo on Docs Site


@dzello I’d like to use algolia/docsearch for the demo if possible? If you’d be willing to help, I have a few quick questions. I have some ideas for tweaking the behavior and whatever we do here will feed into the once I integrate.

Background: This package is basically a cleaned up, enhanced, open-source version of the Navigation component we created over at the main repo.

Updated 29/04/2017 18:18 2 Comments

Investigate Meta-Packages in Meilix and propose ways for configuration


There are metapackages in meilix. These meta-packages can help to define details of a distro including which packages are included, start page and search engines of browsers etc.

Please check out the existing meta-packages and update them. Find out what needs to be changed in order to change browser search engines etc. and update your findings in the

Next steps would be to make a list of items that we will include in the meta-package.

Updated 29/04/2017 14:40

T04-6 incomplete


Finish Chapter 6: Behavior Delegation from You Don’t Know JS: this & Object Prototypes (Book 3)

The following lists sections and subsections in the book to be documented:

  • [ ] Intro
  • Towards Delegation-Oriented Design
    • [ ] Class Theory
    • [ ] Delegation Theory
    • [ ] Mental Models Compared
  • Class vs. Objects
    • [ ] Widget “Classes”
    • [ ] Delegating Widget Objects
  • Simpler Design
    • [ ] Intro
    • [ ] De-class-ified
  • Nicer Syntax
    • [ ] Intro
    • [ ] Unlexical
  • [ ] Introspection
  • [ ] Review (TL;DR)
Updated 29/04/2017 14:00

T04-5 incomplete


Finish Chapter 5: Prototypes from You Don’t Know JS: this & Object Prototypes (Book 3)

The following lists sections and subsections in the book to be documented:

  • [[Prototype]]
    • [ ] `Object.prototype
    • [ ] Setting & Shadowing Properties
  • “Class”
    • [ ] “Class” Function
    • [ ] “Constructors”
    • [ ] Mechanics
  • (Prototypal) Inheritance
    • [ ] Intro
    • [ ] Inspecting “Class” Relationships
  • Object Links
    • [ ] Create()ing Links
    • [ ] Links As Fallback?
  • [ ] Review (TL;DR)
Updated 29/04/2017 13:56

T04-4 incomplete


Finish Chapter 4: Mixing (Up) “Class” Objects from You Don’t Know JS: this & Object Prototypes (Book 3)

The following lists sections and subsections in the book to be documented:

  • Class Theory
    • [ ] Intro
    • [ ] “Class” Design Pattern
    • [ ] JavaScript Class
  • Class Mechanics
    • [ ] Building
    • [ ] Constructor
  • Class Inheritance
    • [ ] Intro
    • [ ] Polymorphism
    • [ ] Multiple Inheritance
  • Mixins
    • [ ] Explicit Mixins
    • [ ] Implicit Mixins
  • [ ] Review (TL;DR)
Updated 29/04/2017 13:51

T04-3 incomplete


Finish Chapter 3: Objects from You Don’t Know JS: this & Object Prototypes (Book 3)

The following lists sections and subsections in the book to be documented:

  • [ ] Syntax
  • [ ] Type
  • Contents
    • [ ] Intro
    • [ ] Computed Property Names
    • [ ] Property vs. Method
    • [ ] Array
    • [ ] Duplicating Objects
    • [ ] Property Descriptors
    • [ ] Immutability
    • [ ] [[Get]]
    • [ ] [[Put]]
    • [ ] Getters & Setters
    • [ ] Existence
  • [ ] Iteration
  • [ ] Review (TL;DR)
Updated 29/04/2017 13:46

T04-2 incomplete


Finish Chapter 2: this All Makes Sense Now! from You Don’t Know JS: this & Object Prototypes (Book 3)

The following lists sections and subsections in the book to be documented:

  • [ ] Call-site
  • Nothing But Rules
    • [ ] Default Binding
    • [ ] Implicit Binding
    • [ ] Explicit Binding
  • Everything in Order
    • [ ] Intro
    • [ ] Determining this
  • Binding Exceptions
    • [ ] Ignored this
    • [ ] Indirection
    • [ ] Sofening Biding
  • [ ] Lexical this
  • [ ] Review (TL;DR)
Updated 29/04/2017 13:32

T04-1 incomplete


Finish Chapter 1: this or That? from You Don’t Know JS: this & Object Prototypes (Book 3)

The following lists sections and subsections in the book to be documented:

  • [ ] Why this?
  • Confusions
    • [ ] Itself
    • [ ] Its Scope
  • [ ] What’s this?
  • [ ] Review (TL;DR)
Updated 29/04/2017 13:27

Guidelines/article how to use 3rd party libraries with Nuxt


Hi guys. This is not an issue, so feel to do what you think better with this topic.

As far as I know, Nuxt, due to it’s awesome out-of-the box features and seamless integration of Vue ecosystem libraries, attract a lot of web-developers and designers with no advanced JS skills (like me, ha-ha). It really makes a lot of magic, and stimulate to professional grow. I love it (sorry, I couldn’t help myself :heart: )

This people use a lot of 3rd party libraries. I am not talking about jQuery plugins, that’s too much, but there’s really a lot of cool stuff, that doesn’t have analogs in Vue ecosystem (beside the fact that a lot of Vue plugins works smoothly with Nuxt too). And it’s really painful to every time figuring out how to integrate another library in SSR Nuxt app.

Just found this article and thought how it be cool, if something like that will be related to Nuxt. I understand, that there’s no silver bullet, every library need individual approach, but I am talking about:

  • Couple real world examples with popular libraries, that needs different integration methods.
  • Guidelines how to handle this process in Nuxt environment.
  • How to know what plugins will work with SSR and Nuxt, and what won’t?

I know, guys behind Nuxt are busy people, so may be somebody from community will be kindly to make it happen (I think it will be cool if it will be in Documentation).

Updated 30/04/2017 08:34 4 Comments

Files in "node_modules/.bin/" are now shell files instead of JS files


pnpm version:


I noticed by finding out the hard way that all the files inside the node_modules/.bin are shell files and not JS files. This means that something like this is no longer possible:

babel-node node_modules/.bin/jasmine

It’s not a big deal because I can do this as a workaround:

babel-node node_modules/jasmine/bin/jasmine.js

But perhaps this difference can be made more prominent in documentation?

Updated 29/04/2017 07:05 1 Comments

provider/azurerm: Add example of a Linux VM w/ Managed Disks


Manual merge required; we have modified the .travis.yml in our fork to do CI of examples.

This example provisions and deploys the following resources into an Azure subscription: - Resource Group - VNet - Subnet - NIC - PIP - Storage Account (for bootDiagnostics) - OS Disk (Managed) - 1TB Data Disk (Managed)

Passing CI process: - terraform get, validate, plan to output, apply output, show - validate with azure CLI - terraform destroy

Updated 30/04/2017 08:59

Docs misleading about extending routes



I was trying to extend routes with router. extendRoutes in nuxt.config.js. In documentation there is written, that:

The schema of the route should respect the vue-router schema.

So I’ve tried to use some vou-router magic, eg. define redirect in form of { path: '/a', redirect: '/b' } as described here or pass props as described here

Then it appeared that some part of vue-router schema are not passed to .nuxt/router.js at all! It looks like only some explicitely defined properties are passed, as you can see here:

In my opinion either documentation should not suggest vue-router schema support (or .nuxt/router.js should consists all routes' properties provided by User, even custom ones :-) )

Updated 30/04/2017 08:35

Broken link to API reference


In at the end of the last paragraph before section titled “OS platforms and hardware compatibility” there is a broken link to the API reference documentation. I’ve encountered this same link other places and I’m really getting frustrated because there seems to be no documentation whatsoever on the .NET Azure IoT Hub sdk. If anyone could point me in the right direction I would be really grateful.

Updated 28/04/2017 20:51

Remove superfluous re: examples from docs

# Backup home directories excluding image thumbnails (i.e. only
# /home/*/.thumbnails is excluded, not /home/*/*/.thumbnails)
$ borg create /path/to/repo::my-files /home \
    --exclude 're:^/home/[^/]+/\.thumbnails/'

# Do the same using a shell-style pattern
$ borg create /path/to/repo::my-files /home \
    --exclude 'sh:/home/*/.thumbnails'

Remove former.

# The contents of directories in '/home' are not backed up when their name
# ends in '.tmp'
$ borg create --exclude 're:^/home/[^/]+\.tmp/' backup /

Rewrite as sh: pattern.

Updated 28/04/2017 20:12

Non-nullish defaults for fields


Do we have a an example yet for default values and non-null? E.g. when you want to display all deactivated items by default?

You would have to use

->value('disabled', ['alwaysRun' => true, 'defaultValue' => true])

along with

echo $this->Form->input('disabled', ['options' => ['' => ' - disabled - ', '0' => 'active']]);

and then it would by default set it to true, unless sth else is passed to switch the value. Maybe we can add a small example to readme?

Updated 30/04/2017 13:13

Any guidance on rendering Swagger-UI in a react app?


Hey guys,

Liking the new direction in Swagger-ui v3!

Our organization has found a ton of value in swagger/Open-API specs and using Swagger-UI to host interactive versions of our APIs.

I’ve been working to extend our (internal) capabilities by creating a pretty light-weight, React based, single-page app that can display all of our uploaded spec files and dynamically render them (with different backend endpoints like dev, stage, prod) in Swagger-UI, all from a single web page.

Going with react since the entire project is serverless and hosted in AWS.

My question….

I know you guys are using react extensively under the hood, but the top level (i.e. swagger core) looks mostly like common js modules. Is there any guidance on consuming swagger-ui components directly inside of a react based project? Has anyone tried it yet? I’ve hit a more than a few speed-bumps up till now (in fairness, react/JSX is pretty new to me still).

At this point, I have a path forward embedding swagger-ui as an iframe in my project and having the target URL for the API spec get pulled from a query parameter, but it would be awesome if there were a more direct way to consume swagger-ui in react.

Thanks for any clarification or guidance in advance. Also curious if I’ve gone completely off-course with how I think react works at this point ;)

Updated 28/04/2017 15:15

PasswordManhole 'no host keys, failing'


I’m trying to go through Quick Tour tutorial, but it looks like PasswordManhole isn’t implemented properly for new Twisted version:

    Traceback (most recent call last):
      File "/home/krna/dev/buildbot-master/.env/lib/python3.6/site-packages/twisted/internet/", line 653, in _runCallbacks
        current.result = callback(current.result, *args, **kw)
      File "/home/krna/dev/buildbot-master/.env/lib/python3.6/site-packages/twisted/internet/", line 1357, in gotResult
        _inlineCallbacks(r, g, deferred)
      File "/home/krna/dev/buildbot-master/.env/lib/python3.6/site-packages/twisted/internet/", line 1299, in _inlineCallbacks
        result = result.throwExceptionIntoGenerator(g)
      File "/home/krna/dev/buildbot-master/.env/lib/python3.6/site-packages/twisted/python/", line 393, in throwExceptionIntoGenerator
        return g.throw(self.type, self.value, self.tb)
    --- <exception caught here> ---
      File "/home/krna/dev/buildbot-master/.env/lib/python3.6/site-packages/buildbot/", line 308, in startService
        yield self.reconfigServiceWithBuildbotConfig(self.config)
      File "/home/krna/dev/buildbot-master/.env/lib/python3.6/site-packages/twisted/internet/", line 1299, in _inlineCallbacks
        result = result.throwExceptionIntoGenerator(g)
      File "/home/krna/dev/buildbot-master/.env/lib/python3.6/site-packages/twisted/python/", line 393, in throwExceptionIntoGenerator
        return g.throw(self.type, self.value, self.tb)
      File "/home/krna/dev/buildbot-master/.env/lib/python3.6/site-packages/buildbot/util/", line 53, in reconfigServiceWithBuildbotConfig
        yield svc.reconfigServiceWithBuildbotConfig(new_config)
    twisted.conch.error.ConchError: ('no host keys, failing', None)

I’m on: asn1crypto==0.22.0 attrs==16.3.0 autobahn==0.18.2 Automat==0.5.0 buildbot==0.9.6 buildbot-console-view==0.9.6 buildbot-waterfall-view==0.9.6 buildbot-worker==0.9.6 buildbot-www==0.9.6 cffi==1.10.0 constantly==15.1.0 cryptography==1.8.1 decorator==4.0.11 future==0.16.0 idna==2.5 incremental==16.10.1 Jinja2==2.9.6 MarkupSafe==1.0 packaging==16.8 pbr==3.0.0 pyasn1==0.2.3 pycparser==2.17 PyJWT==1.5.0 pyparsing==2.2.0 python-dateutil==2.6.0 six==1.10.0 SQLAlchemy==1.1.9 sqlalchemy-migrate==0.11.0 sqlparse==0.2.3 Tempita==0.5.2 Twisted==17.1.0 txaio==2.7.0 zope.interface==4.4.0

Updated 29/04/2017 02:26

database/sql: QueryRow should verify that we have only one row


QueryRow is documented as follows: go // QueryRow executes a query that is expected to return at most one row. // QueryRow always returns a non-nil value. Errors are deferred until // Row's Scan method is called. This suggests that we should get an error if the query returns more than one row. However Row.Scan() doesn’t check that r.rows.Next() returns false after processing one row, so it would ignore any remaining rows.

Conversely “at most one row” suggests that getting no rows is somehow acceptable, but an error is returned in that case. I think it should say “exactly one row”.

Updated 29/04/2017 17:48 3 Comments

Small typo in documentation


In the “Upgrade your Wallabag installation” of the documentation (, the link given is this:

wget && tar xvf latest-v2-package

It should be, right?

Could this be fixed?


Updated 28/04/2017 14:11

Fix documentation building

  • Entry points need to be accessible also when building documentation for all options to be properly generated.
  • Project must be built before generating documentation, otherwise egg-info directory with entry points could be missing or invalid.
  • Building man page using make man command from project directory now uses custom-man builder.
Updated 28/04/2017 13:55

Document on debugging Hadrian


I think it would be nice to have a document on how to debug Hadrian. For example, what tools you typically use to debug it, whether there is some magic switch in either Hadrian or GHC that provides useful information about the build etc.

While it would take quite some time to write a complete guide on this, we can always start with something trivial and do it incrementally. It should be not be a burden.

Updated 28/04/2017 12:53 1 Comments

Link outdated in Plugin Manager, How to write a plugin


Hi! Thanks for reporting this feature/bug/question!

Please keep / fill in the relevant info from this template so that we can help you as best as possible.

Type (choose one): Bug NPE version:

Installed from: ClickOnce

current result Opens NPE’s codeplex page “How to: Write a plugin for NuGet Package Explorer” in browser. Which is for NPE 1 and 2. I am also aware that “CodePlex is shutting down” and “This project has moved”.

expected result Opens browser with link to a github wiki page about “How to: Write a plugin for NuGet Package Explorer” for NPE 3.

Known workarrounds: None - I haven’t found such a wiki page on NPE’s github page so far Is there a version in which it did worked? None that I know of. Is there a package on which shows the bug? not applicable

Updated 29/04/2017 22:49 1 Comments

Documentation: ActivityIndicator, props not shown correctly



I opened the docs page for ActivityIndicator. If you have a look at the props, they are not shown correctly, but size?: [object Object], [object Object] is rendered. There should be a representation of

      PropTypes.oneOf([ 'small', 'large' ]),

Reproduction Steps and Sample Code

  1. Visit
  2. See the props definition


Using PropTypes instead of flow seems to lead to this problem, I will try to convert it to use flow. Otherwise we could try to improve website/server/extractDocs to handle PropTypes better.

Additional Information

  • React Native version: 0.43
  • Platform: web
  • Development Operating System: MacOS
  • Dev tools: none
Updated 28/04/2017 14:29 2 Comments

Provide help page for "drag to install" on Eclipse IoT Marketplace


After #3258 has been implemented, we need to create a user documentation on how this feature can be used. Currently, if the user clicks on the “Install” button in the Eclipse IoT Marketplace, he is forwarded to this page. For ESH listings, this should be replaced by ESH specific information - afaik, the Marketplace supports having different help pages for different catalogues.

Updated 28/04/2017 09:44

docs: Add a provider framework guide.


Document how to write a new provider for Terraform, or contribute new pieces or functionality to an existing provider.

This doc should be largely feature complete. Things I would have liked to included that didn’t make it into this cut:

  • How to make resources importable
  • How to test resources, data sources, migrations, importing, etc.
  • A better explanation of the configuration of a provider, separating out the Schema property and the ConfigureFunc more clearly.
  • A better diagram on the lifecycle page.
  • How to contribute documentation for your provider to the website.
  • Useful practices for log messages.
  • Notes on error wrapping
  • Using timeouts
  • Where, exactly, Exists fits into the lifecycle and when it should be used

While these things would be great to have, I’m calling this the MVP, with an intent to add that information over time (or other people can PR it in). For now, I think what we have is valuable enough to get it published.

Because of the size of this PR, and the number of people involved in reviewing it, it’d be great if reviews could be restricted to just the things that should block a merge. Suggestions for enhancements or future directions are welcome, but it’d be great to keep those as comments. Just keep in mind that changes require people to re-review, that’s all. :)

Updated 28/04/2017 20:22 2 Comments

Sphinx: Move Author Macros


Moves author macros to the right position and enables printing them.

  • sectionauthor: author(s) of the doc
  • moduleauthor: original author and maintainer(s) of the implementation (nor everyone that touched or formatted a file but relevant contributions to that section in modeling and implementing; scope: BA/MA/PhD thesis or sub-project lead)
Updated 28/04/2017 09:28

Document accesibility status (VPAT)


VPAT is kind of accessibility report, it might be useful to have it (probably as part of documentation). On the other side it seems quite complex, so I’m not sure whether it’s worth of the effort. It’s (probably) mostly required by some US state or government organizations.

See wikipedia for more information.

The request has originally ended up in my email:

I work for a state agency in Texas and am wondering if your software has a Voluntary Product Accessibility Template (VPAT)?

Updated 28/04/2017 08:52

文档“单双层RNN API对比介绍”


修改原因:文中使用的示例都是基于v1 api的,需要改成v2 api格式,同时需要将对应的单测示例代码改成v2 api,并保证单测正确。

修改文件:一个中文文件+6个单测示例代码 - 单双层RNN API对比介绍 - sequence_layer_group.conf - sequence_nest_layer_group.conf - sequence_rnn.conf - sequence_nest_rnn.conf - - sequence_nest_rnn_multi_unequalength_inputs.conf

网页链接:develop分支的单双层RNN API对比介绍

Updated 28/04/2017 10:13 1 Comments

Fork me on GitHub