Some fixes in editable packages (conan-io#1337)

* Fixes

* using they

* Fix broken link

Author: lasote

developing_packages/editable_packages.rst

@@ -7,10 +7,10 @@ Packages in editable mode
 
     This is an **experimental** feature subject to breaking changes in future releases.
 
-When working in big projects with several functionalities interconnected it is recomended to avoid
-the one-and-only huge project approach in favor of several libraries each one of them specialized
+When working in big projects with several functionalities interconnected it is recommended to avoid
+the one-and-only huge project approach in favor of several libraries, each one specialized
 in a set of common tasks, even maintained by dedicated teams. This approach helps to isolate
-and reuse code, helps with compiling times and reduces the likelihood of including files that
+and reusing code helps with compiling times and reduces the likelihood of including files that
 not correspond to the API of the required library.
 
 Nevertheless, in some case, it is useful to work in several libraries at the same time and see how
@@ -21,16 +21,14 @@ get the changes ready for a consumer library, it is needed the :command:`conan c
 actually trigger a build to generate the binaries in the cache or to run :command:`conan export-pkg`
 to copy locally built artifacts into the conan cache and make them available to consumers.
 
-What about if you just can tell Conan where to find the headers and the artifacts ready for
-consumption in your local working directory? No need to package, just tell Conan to use those
-artifacts you have just generated with your IDE, sounds good? This is what the feature
-*editable packages* will do for you.
+With the editable packages, you can tell Conan where to find the headers and the artifacts ready for
+consumption in your local working directory. There is no need to package.
 
 Let's see this feature over an example where a developer is creating a ``CoolApp`` but at the same
-time they wants to work on ``cool/version@user/dev`` library which is tightly coupled to the app.
+time they want to work on ``cool/version@user/dev`` library which is tightly coupled to the app.
 
 The package ``cool/version@user/dev`` is already working, the developer has the sources in a
-local folder, they is using whatever method to build and develop locally and can perform
+local folder and they are using whatever method to build and develop locally and can perform
 a :command:`conan create . cool/version@user/dev` to create the package.
 
 Also, there is a *conanfile.txt* (or a more complex recipe) for the application ``CoolApp`` that
@@ -47,14 +45,14 @@ working directory**:
 .. code-block:: bash
 
     $ conan editable add <path/to/local/dev/libcool> cool/version@user/dev
-    # you could do cd <path/to/local/dev/libcool> && conan editable add . cool/version@user/dev
+    # you could do "cd <path/to/local/dev/libcool> && conan editable add . cool/version@user/dev"
 
 
-That is it. Now, every usage of ``cool/version@user/dev``, by any other Conan package, or project
-will be redirected to the ``<path/to/local/dev/libcool>`` user folder, instead of using the package
+That is it. Now, every usage of ``cool/version@user/dev``, by any other Conan package or project,
+will be redirected to the ``<path/to/local/dev/libcool>`` user folder instead of using the package
 from the conan cache.
 
-Conan package recipes define a package "layout" in their ``package_info()`` methods. The default one,
+The Conan package recipes define a package "layout" in their ``package_info()`` methods. The default one,
 if nothing is specified is equivalent to:
 
 .. code-block:: python

integrations/ide/youcompleteme.rst

@@ -3,7 +3,7 @@
 YouCompleteMe (vim)
 -------------------
 
-If you are a vim user, you may also be a user of `YouCompleteMe <http://valloric.github.io/YouCompleteMe/>`_.
+If you are a vim user, you may also be a user of `YouCompleteMe <https://github.com/ycm-core/YouCompleteMe/>`_.
 
 With this generator, you can create the necessary files for your project dependencies, so YouCompleteMe
 will show symbols from your Conan installed dependencies for your project.