========
Concepts
========


.. contents::
   :local:
   :depth: 1


.. _user-concept-projects:

Projects
========

AEN users interact with the system predominantly through projects.

A project is a set of conda environments, Jupyter Notebooks, and
other files.

Each project has a project drive that all team members can
access. The size of the drive is not limited by AEN. Contact
your system administrator if you find you do not have sufficent
space.

Each project has a separate project directory on the project
drive.

The project directory is a directory for project files and data
that is separate from the project owner's and team members' home
directories, so that team members can share and have equal access.

The path to your project directory is
``/projects/<project_owner>/<project_name>``.

For administrative information about projects, directories, and
permissions, see :ref:`admin-concept-projects-permissions`.


.. _user-concept-team:

Team collaboration
==================

Teams collaborate in AEN using projects. Projects allow a team to
easily come together by sharing the resources, applications, and
environments that are necessary to collaborate effectively.

The AEN project owner and any team members connected to their
project will have access to the same:

* Shared files and home directories.
* Shared Python and R environments.
* Shared nodes and hardware.
* Common applications.
* Web user interface.

For more information, see :doc:`basic-tasks/projects/index`.


.. _user-concept-access-control:

Access control
==============

AEN access controls allow you to:

* Add and remove project access for new team members.

* Limit the access to specific folders and files to members of
  your project team.

* Use permissions to extend execute access to team members. By
  default, all of the team members on a project have read and
  write access to all project assets.

Access control is performed from each project's Workbench application.

For more information, see
:doc:`basic-tasks/projects/control-access-to-project`.


.. _user-concept-share-project:

Sharing projects
================

AEN supports both public and private sharing.

A project can be "public," which means that anyone with access
to the system can view the project assets.

Any content placed in the ``public`` folder in a project is
publicly accessible using its URL.

A project can be "private," which means that only the
project owner and team members can view the project assets.

You can also :doc:`limit who can access specific files
<basic-tasks/projects/control-access-to-project>`.


Sharing Jupyter Notebooks
-------------------------

In addition to general project sharing capabilities, you can also
publish Jupyter Notebooks to Anaconda Repository. This
automatically versions the notebook and allows you to define who
can view the notebook.

Project tags
============

Tags are used to:

* Group similar or related projects.
* Identify your project so that it is easier to find.
* Let others know about your project.

You can :doc:`add and remove tags
<basic-tasks/projects/tag-project>` for any project that you have
access to.
