Few issues regarding the documentation

Abierto
  • ¿Algo no está bien?
#182 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
3/5
Tiempo estimado
1-2 días
Aptitud para principiantes
45/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Estancado
Stack tecnológico
python
Área
documentation

Línea de trabajo

Start with doc/source/glossary.rst, then check the CORS and bucket lifecycle mentions at doc/source/tutorial.rst line 102 and b2sdk/api.py lines 194-195. Fix the dead sync.html link in doc/source/quick_start.rst line 77, then review the toctree in doc/source/api_reference.rst lines 44-66 and the REALM_URLS docstring in b2sdk/account_info/abstract.py lines 33-37. Done when each listed item is addressed or explicitly declined by a maintainer, since the thread has no replies.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

enhancement good first issue

Few remarks regarding the documentation were put into the git repository under:

  • doc/source/missing.txt
  • doc/source/remarks.txt

These files were removed in #178 and all issues from there are moved here.

doc/source/missing.txt:

Missing	

1. Missing explanation	
In 	
doc/source/tutorial.rst 	
    line 102 	
AND in 	
b2sdk/api.py 	
    line 194 	
there are mentions of "CORS rules" which are not explained anywhere.	
Nothing in doc/source/glossary.rst either. 	
Proposed fix: add to glossary, if possible, add to on-hover	

2. Missing explanation	
In 	
doc/source/tutorial.rst 	
    line 102	
AND in 	
b2sdk/api.py 	
    line 195	
there are mentions of "bucket lifecycle rules" which are not explained anywhere.	
Nothing in doc/source/glossary.rst either.	
Proposed fix: add to glossary, if possible, add to on-hover	

3. Dead link	
doc/source/quick_start.rst	
    line 77:	
"""	
    To learn more about sync, see `Sync <sync.html>`_.	
"""

doc/source/remarks.txt:

4.	
I cannot find these in code, but some of the elements of .. toctree:: in doc\source\api_reference.rst - lines 44-66 - do not have any titles (the fact that some of the others have them non-descriptive or non-helpful is another matter entirely).	
    api/internal/utils                      - b2sdk.utils	
    api/internal/cache                      - b2sdk.cache	
    api/internal/sync/action                - b2sdk.sync.action	
    api/internal/sync/exception             - b2sdk.sync.exception	
    api/internal/sync/file                  - b2sdk.sync.file	
    api/internal/sync/folder                - b2sdk.sync.folder	
    api/internal/sync/folder_parser         - b2sdk.sync.folder_parser	
    api/internal/sync/policy                - b2sdk.sync.policy	
    api/internal/sync/policy_manager        - b2sdk.sync.policy_manager	
    api/internal/sync/scan_policies         - b2sdk.sync.scan_policies	
    api/internal/sync/sync                  - b2sdk.sync.sync	
    api/internal/transferer/file_metadata   - b2sdk.transferer.file_metadata	
    api/internal/upload_source              - b2sdk.upload_source	


5.	
Dicts get squashed and much less convenient to read/copy from. E.g.:	
b2sdk\account_info\abstract.py, lines 33-37:	
"""	
    REALM_URLS = {	
        'production': 'https://api.backblazeb2.com',	
        'dev': 'http://api.backblazeb2.xyz:8180',	
        'staging': 'https://api.backblaze.net',	
    }	
"""	

while in the docs it looks like this:	
"""	
REALM_URLS = {'dev': 'http://api.backblazeb2.xyz:8180', 'production': 'https://api.backblazeb2.com', 'staging':	
'https://api.backblaze.net'}	
"""
Lenguaje dominante
Python
Estrellas
214
Forks
68
Merge medio
51 min
PR fusionados (30 d)
6

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de Backblaze/b2-sdk-python

Todos los issues de Backblaze/b2-sdk-python

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.