feat(tools): Move sample_project from examples to tools

Extended example readme.md by further development options.

Author: Marek Fiala

examples/README.md

@@ -96,6 +96,18 @@ The `IDF_PATH` environment variable is the only thing that connects the example
 
 If you're looking for a more bare-bones project to start from, try [esp-idf-template](https://github.com/espressif/esp-idf-template).
 
+## Further Development
+
+For further steps on how to develop a project, see the following:
+
+- Managing the project:
+  - [IDF Frontend](https://docs.espressif.com/projects/esp-idf/en/latest/api-guides/build-system.html#start-a-new-project) document
+  - ESP-IDF Getting Started video ([YouTube](https://youtu.be/J8zc8mMNKtc?t=340), [bilibili](https://www.bilibili.com/video/BV1114y1r7du/?t=336))
+  - [Overview](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-guides/build-system.html#example-project) of an example project
+  - [Build System](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/build-system.html) document
+- Writing code:
+  - Write your own code following the [API references](https://docs.espressif.com/projects/esp-idf/en/stable/api-reference/index.html)
+
 ## Contributing Examples
 
 If you have a new example you think we'd like, please consider sending it to us as a Pull Request.

examples/get-started/sample_project/README.md

@@ -427,9 +427,9 @@ def check_exist() -> None:
             check_dirs = {IDF_PATH}
             _exclude_dirs = [os.path.join(IDF_PATH, 'tools', 'unit-test-app'),
                              os.path.join(IDF_PATH, 'tools', 'test_build_system', 'build_test_app'),
-                             os.path.join(IDF_PATH, 'examples', 'get-started', 'sample_project')]
+                             os.path.join(IDF_PATH, 'tools', 'templates', 'sample_project')]
         else:
-            _exclude_dirs = [os.path.join(IDF_PATH, 'examples', 'get-started', 'sample_project')]
+            _exclude_dirs = [os.path.join(IDF_PATH, 'tools', 'templates', 'sample_project')]
 
         extra_default_build_targets_list: List[str] = []
         bypass_check_test_targets_list: List[str] = []

tools/ci/check_build_test_rules.py

@@ -242,3 +242,4 @@ ignore:
     - components/protocomm/python/
     - components/wifi_provisioning/proto-c/
     - components/wifi_provisioning/python/
+    - tools/templates/

tools/ci/check_copyright_config.yaml

@@ -995,7 +995,6 @@ examples/ethernet/basic/main/ethernet_example_main.c
 examples/ethernet/enc28j60/components/eth_enc28j60/enc28j60.h
 examples/ethernet/enc28j60/main/enc28j60_example_main.c
 examples/get-started/blink/main/blink_example_main.c
-examples/get-started/sample_project/main/main.c
 examples/mesh/internal_communication/main/include/mesh_light.h
 examples/mesh/internal_communication/main/mesh_light.c
 examples/mesh/internal_communication/main/mesh_main.c
@@ -1146,8 +1145,6 @@ tools/ble/lib_gatt.py
 tools/catch/catch.hpp
 tools/ldgen/samples/template.ld
 tools/ldgen/test/data/linker_script.ld
-tools/templates/sample_component/include/main.h
-tools/templates/sample_component/main.c
 tools/test_apps/build_system/embed_test/main/test_main.c
 tools/test_apps/build_system/ldgen_test/main/src1.c
 tools/test_apps/build_system/ldgen_test/main/src2.c

tools/ci/check_copyright_ignore.txt

@@ -32,6 +32,9 @@ tools/eclipse-code-style.xml
 tools/format.sh
 tools/mocks/**/*
 tools/set-submodules-to-github.sh
+tools/templates/sample_project/main/main.c
+tools/templates/sample_project/CMakeLists.txt
+tools/templates/sample_project/main/CMakeLists.txt
 tools/templates/sample_component/CMakeLists.txt
 tools/templates/sample_component/include/main.h
 tools/templates/sample_component/main.c

tools/ci/exclude_check_tools_files.txt

@@ -40,7 +40,7 @@ def is_empty_and_create(path: str, action: str) -> None:
 
 def create_project(target_path: str, name: str) -> None:
     copytree(
-        os.path.join(os.environ['IDF_PATH'], 'examples', 'get-started', 'sample_project'),
+        os.path.join(os.environ['IDF_PATH'], 'tools', 'templates', 'sample_project'),
         target_path,
         copy_function=copy,
         dirs_exist_ok=True,
@@ -49,7 +49,6 @@ def create_project(target_path: str, name: str) -> None:
     os.rename(os.path.join(main_folder, 'main.c'), os.path.join(main_folder, '.'.join((name, 'c'))))
     replace_in_file(os.path.join(main_folder, 'CMakeLists.txt'), 'main', name)
     replace_in_file(os.path.join(target_path, 'CMakeLists.txt'), 'main', name)
-    os.remove(os.path.join(target_path, 'README.md'))
 
 
 def create_component(target_path: str, name: str) -> None: