-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy path7197.html
183 lines (181 loc) · 16.8 KB
/
7197.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
<!DOCTYPE html>
<html lang="he">
<!-- Mirrored from forums.pythonic.guru/t/2-class-path/7197 by HTTrack Website Copier/3.x [XR&CO'2014], Sun, 17 Sep 2023 05:13:28 GMT -->
<!-- Added by HTTrack --><meta content="text/html;charset=utf-8" http-equiv="content-type"/><!-- /Added by HTTrack -->
<head>
<meta charset="utf-8"/>
<title>מחברת 2 - class Path - שבוע 7 - פייתון בעברית ובחינם</title>
<meta content="באמצע המחברת יש דוגמה לתיעוד של class Path.
לא לגמרי הבנתי איך הדוגמה מתיישבת עם שלושת שיטות התיעוד השונות הנתונות בהמשך המחברת.
האם זו שיטת כתיבה רביעית, אישית, ומתאימה גם כן?" name="description"/>
<meta content="Discourse 3.2.0.beta2-dev - https://github.com/discourse/discourse version ebe68e15fce9c2fc2c67628ce4a9b24284c09b80" name="generator"/>
<link href="../../uploads/default/optimized/1X/49c4c7d93c7e73a9a15013cfae1d89084c9ba521_2_32x32.jpg" rel="icon" type="image/png"/>
<link href="../../uploads/default/optimized/1X/49c4c7d93c7e73a9a15013cfae1d89084c9ba521_2_180x180.jpg" rel="apple-touch-icon" type="image/png"/>
<meta content="#ffffff" media="all" name="theme-color"/>
<meta content="width=device-width, initial-scale=1.0, minimum-scale=1.0, user-scalable=yes, viewport-fit=cover" name="viewport"/>
<link href="7197.html" rel="canonical"/>
<link href="../../opensearch.xml" rel="search" title="פייתון בעברית ובחינם Search" type="application/opensearchdescription+xml"/>
<link class="light-scheme" href="../../stylesheets/color_definitions_scheme_2_3_4eaabccdb423ebdd5fde62bb8c929b7912b0ba33.css_%3b%20filename_%3dUTF-8%27%27color_definitions_scheme_2_3_4eaabccdb423ebdd5fde62bb8c929b7912b0ba337939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="desktop_rtl" href="../../stylesheets/desktop_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27desktop_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="checklist_rtl" href="../../stylesheets/checklist_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27checklist_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-cakeday_rtl" href="../../stylesheets/discourse-cakeday_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-cakeday_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-calendar_rtl" href="../../stylesheets/discourse-calendar_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-calendar_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-details_rtl" href="../../stylesheets/discourse-details_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-details_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-lazy-videos_rtl" href="../../stylesheets/discourse-lazy-videos_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-lazy-videos_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-local-dates_rtl" href="../../stylesheets/discourse-local-dates_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-local-dates_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-math_rtl" href="../../stylesheets/discourse-math_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-math_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-narrative-bot_rtl" href="../../stylesheets/discourse-narrative-bot_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-narrative-bot_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-presence_rtl" href="../../stylesheets/discourse-presence_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-presence_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-solved_rtl" href="../../stylesheets/discourse-solved_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-solved_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-tooltips_rtl" href="../../stylesheets/discourse-tooltips_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-tooltips_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="docker_manager_rtl" href="../../stylesheets/docker_manager_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27docker_manager_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="poll_rtl" href="../../stylesheets/poll_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27poll_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="discourse-calendar_desktop_rtl" href="../../stylesheets/discourse-calendar_desktop_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27discourse-calendar_desktop_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="poll_desktop_rtl" href="../../stylesheets/poll_desktop_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce.css_%3b%20filename_%3dUTF-8%27%27poll_desktop_rtl_010e86cdc443c6a22fa77214fa3fc0bf2f3542ce7939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link data-target="desktop_theme" data-theme-id="3" data-theme-name="בהיר" href="../../stylesheets/desktop_theme_3_32d9a33a83c213d82cb6da72bd3eb36192a74400.css_%3b%20filename_%3dUTF-8%27%27desktop_theme_3_32d9a33a83c213d82cb6da72bd3eb36192a744007939.css?__ws=forums.pythonic.guru" media="all" rel="stylesheet"/>
<link href="7197.rss" rel="alternate nofollow" title="הזנת RSS של ‚מחברת 2 - class Path’" type="application/rss+xml"/>
<meta content="פייתון בעברית ובחינם" property="og:site_name"/>
<meta content="website" property="og:type"/>
<meta content="summary" name="twitter:card"/>
<meta content="../../uploads/default/original/1X/49c4c7d93c7e73a9a15013cfae1d89084c9ba521.jpg" name="twitter:image"/>
<meta content="../../uploads/default/original/1X/49c4c7d93c7e73a9a15013cfae1d89084c9ba521.jpg" property="og:image"/>
<meta content="7197.html" property="og:url"/>
<meta content="7197.html" name="twitter:url"/>
<meta content="מחברת 2 - class Path" property="og:title"/>
<meta content="מחברת 2 - class Path" name="twitter:title"/>
<meta content="באמצע המחברת יש דוגמה לתיעוד של class Path. לא לגמרי הבנתי איך הדוגמה מתיישבת עם שלושת שיטות התיעוד השונות הנתונות בהמשך המחברת. האם זו שיטת כתיבה רביעית, אישית, ומתאימה גם כן?" property="og:description"/>
<meta content="באמצע המחברת יש דוגמה לתיעוד של class Path. לא לגמרי הבנתי איך הדוגמה מתיישבת עם שלושת שיטות התיעוד השונות הנתונות בהמשך המחברת. האם זו שיטת כתיבה רביעית, אישית, ומתאימה גם כן?" name="twitter:description"/>
<meta content="הקורס הפתוח" property="og:article:section"/>
<meta content="0088CC" property="og:article:section:color"/>
<meta content="שבוע 7" property="og:article:section"/>
<meta content="0088CC" property="og:article:section:color"/>
<meta content="תיעוד" property="og:article:tag"/>
<meta name="twitter:label1" value="זמן קריאה"/>
<meta name="twitter:data1" value="1 mins 🕑"/>
<meta name="twitter:label2" value="לייקים"/>
<meta name="twitter:data2" value="1 ❤"/>
<meta content="2020-06-18T10:38:48+00:00" property="article:published_time"/>
<meta content="true" property="og:ignore_canonical"/>
<script type="application/ld+json">{"@context":"http://schema.org","@type":"QAPage","name":"מחברת 2 - class Path","mainEntity":{"@type":"Question","name":"מחברת 2 - class Path","text":"באמצע המחברת יש דוגמה לתיעוד של class Path.\n\nלא לגמרי הבנתי איך הדוגמה מתיישבת עם שלושת שיטות התיעוד השונות הנתונות בהמשך המחברת.\n\nהאם זו שיטת כתיבה רביעית, אישית, ומתאימה גם כן?","upvoteCount":0,"answerCount":1,"dateCreated":"2020-06-18T10:38:48.775Z","author":{"@type":"Person","name":"מיתר גלעדי"},"acceptedAnswer":{"@type":"Answer","text":"היא לא כ"כ :slight_smile:\n\nשיטת התיעוד של Path באמצע המחברת היא בסדר ועונה על PEP 8 ועל PEP 257, שמגדירים נימוסים בנוגע לתיעוד. אם תתעד ככה הכל יהיה בסדר ואף אחד לא יכעס.\n\nמה שכן, בעתיד, כשנבנה קוד קצת יותר ארוך ונרצה ליצור ממנו מסמכי דוקומנטציה – Sphinx פחות ידע לאכול את התיעוד הזה, ולכן עדיף לבחור…","upvoteCount":1,"dateCreated":"2020-06-18T11:34:10.850Z","url":"https://forums.pythonic.guru/t/2-class-path/7197/2","author":{"@type":"Person","name":"Yam"}}}}</script>
</head>
<body class="">
<header class="d-header">
<div class="wrap content">
<div class="title">
<a data-auto-route="true" href="/index.html">
<img alt="פייתון בעברית ובחינם" class="logo-big" id="site-logo" src="/uploads/default/original/1X/3c7e2ccc77e214fb4e38daa421f1b8878a5677f9.jpg"/>
</a>
<div class="before-header-panel-outlet"></div>
<div class="panel" role="navigation">
<span class="header-buttons"></span>
<ul class="icons d-header-icons">
<!-- More to come? -->
</ul>
</div>
</div>
</div></header>
<div class="wrap" id="main-outlet" role="main">
<div id="topic-title">
<h1>
<a href="7197.html">מחברת 2 - class Path</a>
</h1>
<div class="topic-category" itemscope="" itemtype="http://schema.org/BreadcrumbList">
<span itemprop="itemListElement" itemscope="" itemtype="http://schema.org/ListItem">
<a class="badge-wrapper bullet" href="../../c/old/20.html" itemprop="item">
<span class="badge-category-bg" style="background-color: #0088CC"></span>
<span class="badge-category clear-badge">
<span class="category-name" itemprop="name">הקורס הפתוח</span>
</span>
</a>
<meta content="1" itemprop="position"/>
</span>
<span itemprop="itemListElement" itemscope="" itemtype="http://schema.org/ListItem">
<a class="badge-wrapper bullet" href="../../c/old/week-7/17.html" itemprop="item">
<span class="badge-category-bg" style="background-color: #0088CC"></span>
<span class="badge-category clear-badge">
<span class="category-name" itemprop="name">שבוע 7</span>
</span>
</a>
<meta content="2" itemprop="position"/>
</span>
</div>
<div class="topic-category">
<div class="discourse-tags list-tags"><span class="tags-string">תגיות: </span>
<a class="discourse-tag" href="../../tag/%d7%aa%d7%99%d7%a2%d7%95%d7%93.html" rel="tag">תיעוד</a>
</div>
</div>
</div>
<div itemscope="" itemtype="http://schema.org/DiscussionForumPosting">
<meta content="מחברת 2 - class Path" itemprop="headline"/>
<meta content="שבוע 7" itemprop="articleSection"/>
<meta content="תיעוד" itemprop="keywords"/>
<div itemprop="publisher" itemscope="" itemtype="http://schema.org/Organization">
<meta content="פייתון בעברית ובחינם" itemprop="name"/>
<div itemprop="logo" itemscope="" itemtype="http://schema.org/ImageObject">
<meta content="../../uploads/default/original/1X/3c7e2ccc77e214fb4e38daa421f1b8878a5677f9.jpg" itemprop="url"/>
</div>
</div>
<div class="topic-body crawler-post" id="post_1">
<div class="crawler-post-meta">
<span class="creator" itemprop="author" itemscope="" itemtype="http://schema.org/Person">
<span itemprop="name">mgblamg</span>
</span>
<link href="7197.html" itemprop="mainEntityOfPage"/>
<span class="crawler-post-infos">
<time class="post-time" datetime="2020-06-18T10:38:48Z" itemprop="datePublished">
18 ביוני, 2020, 10:38am
</time>
<meta content="2021-11-21T01:24:16Z" itemprop="dateModified"/>
</span>
</div>
<div class="post" itemprop="articleBody">
<p>באמצע המחברת יש דוגמה לתיעוד של class Path.<br/>
לא לגמרי הבנתי איך הדוגמה מתיישבת עם שלושת שיטות התיעוד השונות הנתונות בהמשך המחברת.<br/>
האם זו שיטת כתיבה רביעית, אישית, ומתאימה גם כן?</p>
</div>
<div itemprop="interactionStatistic" itemscope="" itemtype="http://schema.org/InteractionCounter">
<meta content="http://schema.org/LikeAction" itemprop="interactionType"/>
<meta content="0" itemprop="userInteractionCount"/>
<span class="post-likes"></span>
</div>
<div itemprop="interactionStatistic" itemscope="" itemtype="http://schema.org/InteractionCounter">
<meta content="http://schema.org/CommentAction" itemprop="interactionType"/>
<meta content="0" itemprop="userInteractionCount"/>
</div>
</div>
<div class="topic-body crawler-post" id="post_2" itemprop="comment" itemscope="" itemtype="http://schema.org/Comment">
<div class="crawler-post-meta">
<span class="creator" itemprop="author" itemscope="" itemtype="http://schema.org/Person">
<span itemprop="name">Yam</span>
</span>
<link href="7197.html" itemprop="mainEntityOfPage"/>
<span class="crawler-post-infos">
<time class="post-time" datetime="2020-06-18T11:34:10Z" itemprop="datePublished">
18 ביוני, 2020, 11:34am
</time>
<meta content="2020-06-18T11:34:10Z" itemprop="dateModified"/>
</span>
</div>
<div class="post" itemprop="text">
<p>היא לא כ"כ <img alt=":slight_smile:" class="emoji" src="../../images/emoji/twitter/slight_smilec164.png?v=9" title=":slight_smile:"/></p>
<p>שיטת התיעוד של Path באמצע המחברת היא בסדר ועונה על PEP 8 ועל PEP 257, שמגדירים נימוסים בנוגע לתיעוד. אם תתעד ככה הכל יהיה בסדר ואף אחד לא יכעס.</p>
<p>מה שכן, בעתיד, כשנבנה קוד קצת יותר ארוך ונרצה ליצור ממנו מסמכי דוקומנטציה – Sphinx פחות ידע לאכול את התיעוד הזה, ולכן עדיף לבחור אחת משיטות התיעוד המסוגננות שמופיעות בהמשך המחברת.<br/>
הרעיון של class Path באמצע המחברת היא דוגמת ביניים שנועדה להראות את הטכניקה של תיעוד, אבל לא את סגנונות התיעוד (שהיסטורית, התפתחו מאוחר יותר).</p>
</div>
<div itemprop="interactionStatistic" itemscope="" itemtype="http://schema.org/InteractionCounter">
<meta content="http://schema.org/LikeAction" itemprop="interactionType"/>
<meta content="1" itemprop="userInteractionCount"/>
<span class="post-likes">לייק 1</span>
</div>
<div itemprop="interactionStatistic" itemscope="" itemtype="http://schema.org/InteractionCounter">
<meta content="http://schema.org/CommentAction" itemprop="interactionType"/>
<meta content="0" itemprop="userInteractionCount"/>
</div>
</div>
</div>
</div>
<footer class="container wrap">
</footer>
<span class_="highlight-scripts"><link href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/default.min.css" rel="stylesheet"/><script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/languages/go.min.js"></script></span><span class_="highlight-scripts"><link href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/styles/default.min.css" rel="stylesheet"/><script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/highlight.min.js"></script><script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.8.0/languages/go.min.js"></script><script>hljs.highlightAll();</script></span></body>
<!-- Mirrored from forums.pythonic.guru/t/2-class-path/7197 by HTTrack Website Copier/3.x [XR&CO'2014], Sun, 17 Sep 2023 05:13:29 GMT -->
</html>