Merge pull request #383 from Anaconda-Platform/relase0.11

changelog for 0.11.0

CHANGELOG.md

@@ -2,13 +2,39 @@
 
 We [keep a changelog.](http://keepachangelog.com/)
 
+## Version 0.11.0
+
+### Bug fixes
+
+* [PR 326](https://github.com/Anaconda-Platform/anaconda-project/pull/326) Fix extract for zipfiles from Github/Gitlab
+* [PR 356](https://github.com/Anaconda-Platform/anaconda-project/pull/356) Add tdqm dependency for progress bars. Resolves [355](https://github.com/Anaconda-Platform/anaconda-project/issues/355), [382](https://github.com/Anaconda-Platform/anaconda-project/issues/382)
+* [PR 380](https://github.com/Anaconda-Platform/anaconda-project/pull/380) realpath for safety on Windows. Resolves [Issue 379](https://github.com/Anaconda-Platform/anaconda-project/issues/379) and [Issue 344](https://github.com/Anaconda-Platform/anaconda-project/issues/344)
+
+### Enhancements
+
+* [PR 352](https://github.com/Anaconda-Platform/anaconda-project/pull/352) Add Linux and Mac arm platforms. Resolves [Issue 336](https://github.com/Anaconda-Platform/anaconda-project/issues/336) and [PR 274](https://github.com/Anaconda-Platform/anaconda-project/pull/274) **Breaking change**
+* [PR 386](https://github.com/Anaconda-Platform/anaconda-project/pull/386) Enables ``ANACONDA_PROJECT_DISABLE_OVERRIDE_CHANNELS`` env variable to revert PR 352 if needed
+
+### Maintenance
+
+* [PR 358](https://github.com/Anaconda-Platform/anaconda-project/pull/358) Update CONTRIBUTING.md
+* Docs PRs [369](https://github.com/Anaconda-Platform/anaconda-project/pull/369), [370](https://github.com/Anaconda-Platform/anaconda-project/pull/370), [371](https://github.com/Anaconda-Platform/anaconda-project/pull/371), [372](https://github.com/Anaconda-Platform/anaconda-project/pull/372), [373](https://github.com/Anaconda-Platform/anaconda-project/pull/373), [374](https://github.com/Anaconda-Platform/anaconda-project/pull/374)
+* [PR 384](https://github.com/Anaconda-Platform/anaconda-project/pull/384) Drop Python 2.7 tests, add Python 3.9, 3.10 and Conda 4.11 - 4.13
+
+### Issues closed
+* [Issue 339](https://github.com/Anaconda-Platform/anaconda-project/issues/339) Downloading a file with no content-length in its header fails
+* [Issue 379](https://github.com/Anaconda-Platform/anaconda-project/issues/379) infinite loop on windows: searching for files
+* [Issue 344](https://github.com/Anaconda-Platform/anaconda-project/issues/344) Anaconda-project appears to lockup if run on an empty directory.
+* [Issue 336](https://github.com/Anaconda-Platform/anaconda-project/issues/336) Allow one to use --override-channels for reproducibility
+
 ## Version 0.10.2
 
 ### Bug fixes
 
 * [PR 340](https://github.com/Anaconda-Platform/anaconda-project/pull/340) Fix issue with progress bar
 
 
+
 ## Version 0.10.1
 
 ### Enhancements
@@ -28,6 +54,7 @@ We [keep a changelog.](http://keepachangelog.com/)
 * [Issue 196](https://github.com/Anaconda-Platform/anaconda-project/issues/196) support multi-line commands ([PR 317](https://github.com/Anaconda-Platform/anaconda-project/pull/317))
 * [Issue 252](https://github.com/Anaconda-Platform/anaconda-project/issues/252) Packages installed when none requested ([PR 322](https://github.com/Anaconda-Platform/anaconda-project/pull/322))
 * [Issue 253](https://github.com/Anaconda-Platform/anaconda-project/issues/253) Docs rendering problem
+* [Issue 329](https://github.com/Anaconda-Platform/anaconda-project/issues/329) file download progress bar
 
 ### Enhancements
 

docs/.gitignore

@@ -0,0 +1 @@
+env/

docs/source/user-guide/tasks/work-with-packages.rst

@@ -104,6 +104,64 @@ the ``pip:`` key within the ``packages:`` list. For example,
 
 Then run ``anaconda-project prepare`` to install the new packages into the environment.
 
+****************
+Package Channels
+****************
+
+.. note::
+
+  *Breaking Change in version 0.11.0*. All channels you wish to search through for packages must be supplied on the CLI
+  or in the project YAML file.  To support reproducible projects that build the same way for different users, Anaconda Project will not respect channels declared in your ``.condarc`` file.
+
+Up till now we have not instructed Conda to install packages from specific channels, so all packages are installed from
+the Conda default channels. The default channels
+will be used if there is no specific channel requested with ``anaconda-project add-packages`` and
+no ``channels:`` key in the ``anaconda-project.yml`` file, as in this example:
+
+.. code-block:: yaml
+
+  name: ExampleProject
+
+  packages:
+    - python=3.8
+    - notebook
+    - pandas
+    - pip:
+      - requests
+  
+  env_specs:
+    default: {}
+
+To install packages from one or more channels use the ``-c <channel-name>`` flag, just like
+``conda install``. To specify multiple channels add more ``-c <channel-name>`` flags. The order
+in which the flags appear is the order that Conda will check for available packages. Equivalently,
+you can edit the ``anaconda-project.yml`` to supply a list of channels in the ``channels:`` key.
+
+For example::
+
+  anaconda-project add-packages -c defaults -c conda-forge fastapi
+
+The resulting ``anaconda-project.yml`` file is now
+
+.. code-block:: yaml
+
+  name: ExampleProject
+
+  packages:
+    - python=3.8
+    - notebook
+    - pandas
+    - pip:
+      - requests
+
+  channels:
+    - defaults
+    - conda-forge
+
+  env_specs:
+    default: {}
+
+
 *****************
 Removing packages
 *****************