Gói cao su trăn

quy tắc chung

Các tài liệu phải được xác định bằng ba dấu ngoặc kép. Không được để trống dòng nào trước hoặc sau chuỗi tài liệu. Văn bản bắt đầu ở dòng tiếp theo sau dấu ngoặc kép mở đầu. Các trích dẫn kết thúc có dòng riêng [có nghĩa là chúng không ở cuối câu cuối cùng]

Trong một số trường hợp hiếm hoi, các kiểu còn lại như văn bản in đậm hoặc in nghiêng sẽ được sử dụng trong chuỗi tài liệu, nhưng mã nội tuyến thường được trình bày giữa các dấu gạch ngược. Sau đây được coi là mã nội tuyến

• Tên của một tham số

• Mã Python, một mô-đun, chức năng, tích hợp sẵn, loại, chữ… [e. g.

  def func[]:
  
      """Some function.
  
      With several mistakes in the docstring.
  
      It has a blank like after the signature ``def func[]:``.
  
      The text 'Some function' should go in the line after the
      opening quotes of the docstring, not in the same line.
  
      There is a blank line between the docstring and the first line
      of code ``foo = 1``.
  
      The closing quotes should be in the next line, not in this one."""
  
      foo = 1
      bar = 2
      return foo + bar
  

  8,

  def func[]:
  
      """Some function.
  
      With several mistakes in the docstring.
  
      It has a blank like after the signature ``def func[]:``.
  
      The text 'Some function' should go in the line after the
      opening quotes of the docstring, not in the same line.
  
      There is a blank line between the docstring and the first line
      of code ``foo = 1``.
  
      The closing quotes should be in the next line, not in this one."""
  
      foo = 1
      bar = 2
      return foo + bar
  

  9,

  def astype[dtype]:
      """
      Cast Series type.
  
      This section will provide further details.
      """
      pass
  

  0,

  def astype[dtype]:
      """
      Cast Series type.
  
      This section will provide further details.
      """
      pass
  

  1,

  def astype[dtype]:
      """
      Cast Series type.
  
      This section will provide further details.
      """
      pass
  

  2]

• Một lớp gấu trúc [ở dạng

  def astype[dtype]:
      """
      Cast Series type.
  
      This section will provide further details.
      """
      pass
  

  3]

• Phương pháp gấu trúc [ở dạng

  def astype[dtype]:
      """
      Cast Series type.
  
      This section will provide further details.
      """
      pass
  

  4]

• Hàm pandas [ở dạng

  def astype[dtype]:
      """
      Cast Series type.
  
      This section will provide further details.
      """
      pass
  

  5]

Ghi chú

Để chỉ hiển thị thành phần cuối cùng của lớp, phương thức hoặc chức năng được liên kết, hãy thêm tiền tố vào nó bằng ______3_______6. Ví dụ:

def astype[dtype]:
    """
    Cast Series type.

    This section will provide further details.
    """
    pass

def astype[dtype]:
    """
    Cast Series type.

    This section will provide further details.
    """
    pass

def astype[dtype]:
    """
    Cast Series type.

    This section will provide further details.
    """
    pass

Tốt

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

Xấu

def func[]:

    """Some function.

    With several mistakes in the docstring.

    It has a blank like after the signature ``def func[]:``.

    The text 'Some function' should go in the line after the
    opening quotes of the docstring, not in the same line.

    There is a blank line between the docstring and the first line
    of code ``foo = 1``.

    The closing quotes should be in the next line, not in this one."""

    foo = 1
    bar = 2
    return foo + bar

Phần 1. tóm tắt ngắn

Tóm tắt ngắn gọn là một câu duy nhất diễn đạt những gì chức năng thực hiện một cách ngắn gọn

Tóm tắt ngắn phải bắt đầu bằng chữ in hoa, kết thúc bằng dấu chấm và nằm trong một dòng. Nó cần thể hiện những gì đối tượng làm mà không cung cấp chi tiết. Đối với các hàm và phương thức, phần tóm tắt ngắn phải bắt đầu bằng một động từ nguyên thể

Tốt

def astype[dtype]:
    """
    Cast Series type.

    This section will provide further details.
    """
    pass

Xấu

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Method to cast Series type.

    Does not start with verb.
    """
    pass

def astype[dtype]:
    """
    Cast Series type

    Missing dot at the end.
    """
    pass

def astype[dtype]:
    """
    Cast Series type from its current type to the new type defined in
    the parameter dtype.

    Summary is too verbose and doesn't fit in a single line.
    """
    pass

Phần 2. tóm tắt mở rộng

Tóm tắt mở rộng cung cấp chi tiết về những gì chức năng làm. Nó không nên đi sâu vào chi tiết của các thông số, hoặc thảo luận về ghi chú thực hiện, mà sẽ đi vào các phần khác

Một dòng trống được để lại giữa phần tóm tắt ngắn và phần tóm tắt mở rộng. Mỗi đoạn trong phần tóm tắt mở rộng đều kết thúc bằng dấu chấm

Phần tóm tắt mở rộng sẽ cung cấp chi tiết về lý do tại sao chức năng này hữu ích và các trường hợp sử dụng của chúng, nếu nó không quá chung chung

def unstack[]:
    """
    Pivot a row index to columns.

    When using a MultiIndex, a level can be pivoted so each value in
    the index becomes a column. This is especially useful when a subindex
    is repeated for the main index, and data is easier to visualize as a
    pivot table.

    The index level will be automatically removed from the index when added
    as columns.
    """
    pass

Phần 3. thông số

Chi tiết các tham số sẽ được bổ sung trong phần này. Phần này có tiêu đề “Thông số”, theo sau là một dòng có dấu gạch nối dưới mỗi chữ cái của từ “Thông số”. Một dòng trống được để lại trước tiêu đề của phần, nhưng không phải sau và không phải giữa dòng có từ "Tham số" và dòng có dấu gạch nối

Sau tiêu đề, mỗi thông số trong chữ ký phải được ghi lại, bao gồm

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

Các tham số được xác định theo tên của chúng, theo sau là khoảng trắng, dấu hai chấm, dấu cách khác và loại [hoặc các loại]. Lưu ý rằng khoảng cách giữa tên và dấu hai chấm rất quan trọng. Các loại không được xác định cho

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

Đối với các đối số từ khóa có giá trị mặc định, giá trị mặc định sẽ được liệt kê sau dấu phẩy ở cuối loại. Hình thức chính xác của loại trong trường hợp này sẽ là “int, default 0”. Trong một số trường hợp, có thể hữu ích khi giải thích đối số mặc định nghĩa là gì, có thể được thêm vào sau dấu phẩy “int, default -1, có nghĩa là tất cả cpus”

Trong trường hợp giá trị mặc định là

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Method to cast Series type.

    Does not start with verb.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

def astype[dtype]:
    """
    Method to cast Series type.

    Does not start with verb.
    """
    pass

def astype[dtype]:
    """
    Method to cast Series type.

    Does not start with verb.
    """
    pass

Tốt

class Series:
    def plot[self, kind, color='blue', **kwargs]:
        """
        Generate a plot.

        Render the data in the Series as a matplotlib plot of the
        specified kind.

        Parameters
        ----------
        kind : str
            Kind of matplotlib plot.
        color : str, default 'blue'
            Color name or rgb code.
        **kwargs
            These parameters will be passed to the matplotlib plotting
            function.
        """
        pass

Xấu

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def astype[dtype]:
    """
    Method to cast Series type.

    Does not start with verb.
    """
    pass

def astype[dtype]:
    """
    Method to cast Series type.

    Does not start with verb.
    """
    pass

def astype[dtype]:
    """
    Method to cast Series type.

    Does not start with verb.
    """
    pass

def astype[dtype]:
    """
    Method to cast Series type.

    Does not start with verb.
    """
    pass

def astype[dtype]:
    """
    Casts Series type.

    Verb in third-person of the present simple, should be infinitive.
    """
    pass

phần 4. lợi nhuận hoặc sản lượng

Nếu phương thức trả về một giá trị, nó sẽ được ghi lại trong phần này. Ngoài ra nếu phương thức mang lại đầu ra của nó

Tiêu đề của phần sẽ được xác định theo cách tương tự như “Thông số”. Với các tên “Returns” hoặc “Yields” theo sau là một dòng có nhiều dấu gạch nối bằng các chữ cái trong từ trước đó

Các tài liệu của sự trở lại cũng tương tự như các thông số. Nhưng trong trường hợp này, sẽ không có tên nào được cung cấp, trừ khi phương thức trả về hoặc mang lại nhiều hơn một giá trị [một bộ giá trị]

Các loại cho “Lợi nhuận” và “Lợi nhuận” giống như các loại cho “Tham số”. Ngoài ra, phần mô tả phải kết thúc bằng dấu chấm

Ví dụ, với một giá trị duy nhất

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

Với nhiều hơn một giá trị

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

Nếu phương pháp mang lại giá trị của nó

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

Phần 5. Xem thêm

Phần này được sử dụng để cho người dùng biết về chức năng gấu trúc liên quan đến chức năng đang được ghi lại. Trong một số ít trường hợp, nếu không tìm thấy phương thức hoặc chức năng liên quan nào, phần này có thể được bỏ qua

Một ví dụ rõ ràng sẽ là các phương thức

def astype[dtype]:
    """
    Cast Series type

    Missing dot at the end.
    """
    pass

def astype[dtype]:
    """
    Cast Series type

    Missing dot at the end.
    """
    pass

def astype[dtype]:
    """
    Cast Series type

    Missing dot at the end.
    """
    pass

def astype[dtype]:
    """
    Cast Series type

    Missing dot at the end.
    """
    pass

def astype[dtype]:
    """
    Cast Series type.

    This section will provide further details.
    """
    pass

def astype[dtype]:
    """
    Cast Series type

    Missing dot at the end.
    """
    pass

Để đưa ra một trực giác về những gì có thể được coi là liên quan, đây là một số ví dụ

• def astype[dtype]:
      """
      Cast Series type
  
      Missing dot at the end.
      """
      pass
  

  7 và

  def astype[dtype]:
      """
      Cast Series type
  
      Missing dot at the end.
      """
      pass
  

  8, khi họ làm như vậy, nhưng trong một trường hợp cung cấp các chỉ số và ở các vị trí khác

• def astype[dtype]:
      """
      Cast Series type
  
      Missing dot at the end.
      """
      pass
  

  9 và

  def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  0, khi chúng làm ngược lại

• def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  1,

  def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  2 và

  def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  3, vì người dùng dễ dàng tìm kiếm phương thức lặp qua các cột lại kết thúc bằng phương thức lặp qua hàng và ngược lại

• def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  4 và

  def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  5, vì cả hai phương pháp đều được sử dụng để xử lý các giá trị bị thiếu

• def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  6 và

  def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  7, vì chúng bổ sung cho nhau

• def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  8 và

  def astype[dtype]:
      """
      Cast Series type from its current type to the new type defined in
      the parameter dtype.
  
      Summary is too verbose and doesn't fit in a single line.
      """
      pass
  

  9, vì cái này là sự tổng quát hóa của cái kia

• def unstack[]:
      """
      Pivot a row index to columns.
  
      When using a MultiIndex, a level can be pivoted so each value in
      the index becomes a column. This is especially useful when a subindex
      is repeated for the main index, and data is easier to visualize as a
      pivot table.
  
      The index level will be automatically removed from the index when added
      as columns.
      """
      pass
  

  0 và

  def unstack[]:
      """
      Pivot a row index to columns.
  
      When using a MultiIndex, a level can be pivoted so each value in
      the index becomes a column. This is especially useful when a subindex
      is repeated for the main index, and data is easier to visualize as a
      pivot table.
  
      The index level will be automatically removed from the index when added
      as columns.
      """
      pass
  

  1, vì người dùng có thể đang đọc tài liệu về

  def unstack[]:
      """
      Pivot a row index to columns.
  
      When using a MultiIndex, a level can be pivoted so each value in
      the index becomes a column. This is especially useful when a subindex
      is repeated for the main index, and data is easier to visualize as a
      pivot table.
  
      The index level will be automatically removed from the index when added
      as columns.
      """
      pass
  

  0 để biết cách bỏ ngày tháng và cách thực hiện là với

  def unstack[]:
      """
      Pivot a row index to columns.
  
      When using a MultiIndex, a level can be pivoted so each value in
      the index becomes a column. This is especially useful when a subindex
      is repeated for the main index, and data is easier to visualize as a
      pivot table.
  
      The index level will be automatically removed from the index when added
      as columns.
      """
      pass
  

  1

• def unstack[]:
      """
      Pivot a row index to columns.
  
      When using a MultiIndex, a level can be pivoted so each value in
      the index becomes a column. This is especially useful when a subindex
      is repeated for the main index, and data is easier to visualize as a
      pivot table.
  
      The index level will be automatically removed from the index when added
      as columns.
      """
      pass
  

  4 có liên quan đến

  def unstack[]:
      """
      Pivot a row index to columns.
  
      When using a MultiIndex, a level can be pivoted so each value in
      the index becomes a column. This is especially useful when a subindex
      is repeated for the main index, and data is easier to visualize as a
      pivot table.
  
      The index level will be automatically removed from the index when added
      as columns.
      """
      pass
  

  5, vì chức năng của nó dựa trên nó

Khi quyết định những gì có liên quan, bạn chủ yếu nên sử dụng cảm giác thông thường của mình và suy nghĩ về những gì có thể hữu ích cho người dùng đọc tài liệu, đặc biệt là những người ít kinh nghiệm hơn

Khi liên quan đến các thư viện khác [chủ yếu là

def unstack[]:
    """
    Pivot a row index to columns.

    When using a MultiIndex, a level can be pivoted so each value in
    the index becomes a column. This is especially useful when a subindex
    is repeated for the main index, and data is easier to visualize as a
    pivot table.

    The index level will be automatically removed from the index when added
    as columns.
    """
    pass

def unstack[]:
    """
    Pivot a row index to columns.

    When using a MultiIndex, a level can be pivoted so each value in
    the index becomes a column. This is especially useful when a subindex
    is repeated for the main index, and data is easier to visualize as a
    pivot table.

    The index level will be automatically removed from the index when added
    as columns.
    """
    pass

def unstack[]:
    """
    Pivot a row index to columns.

    When using a MultiIndex, a level can be pivoted so each value in
    the index becomes a column. This is especially useful when a subindex
    is repeated for the main index, and data is easier to visualize as a
    pivot table.

    The index level will be automatically removed from the index when added
    as columns.
    """
    pass

def unstack[]:
    """
    Pivot a row index to columns.

    When using a MultiIndex, a level can be pivoted so each value in
    the index becomes a column. This is especially useful when a subindex
    is repeated for the main index, and data is easier to visualize as a
    pivot table.

    The index level will be automatically removed from the index when added
    as columns.
    """
    pass

Phần này có tiêu đề, “Xem thêm” [lưu ý chữ S và A viết hoa], theo sau là dòng có dấu gạch ngang và phía trước là dòng trống

Sau tiêu đề, chúng tôi sẽ thêm một dòng cho từng phương thức hoặc chức năng có liên quan, theo sau là khoảng trắng, dấu hai chấm, một khoảng trắng khác và một mô tả ngắn minh họa chức năng của phương thức hoặc chức năng này, tại sao nó có liên quan trong ngữ cảnh này và điều gì . Phần mô tả cũng phải kết thúc bằng dấu chấm

Lưu ý rằng trong "Returns" và "Yields", mô tả nằm trên dòng sau loại. Tuy nhiên, trong phần này, nó nằm trên cùng một dòng, với dấu hai chấm ở giữa. Nếu mô tả không vừa trên cùng một dòng, nó có thể tiếp tục trên các dòng khác và phải được thụt vào thêm

Ví dụ

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

Phần 6. ghi chú

Đây là phần tùy chọn được sử dụng để ghi chú về việc triển khai thuật toán hoặc để ghi lại các khía cạnh kỹ thuật của hành vi chức năng

Vui lòng bỏ qua nó, trừ khi bạn đã quen với việc triển khai thuật toán hoặc bạn phát hiện ra một số hành vi phản trực giác trong khi viết các ví dụ cho hàm

Phần này tuân theo định dạng giống như phần tóm tắt mở rộng

Phần 7. ví dụ

Đây là một trong những phần quan trọng nhất của chuỗi tài liệu, mặc dù được đặt ở vị trí cuối cùng, vì mọi người thường hiểu các khái niệm tốt hơn bằng ví dụ hơn là thông qua giải thích chính xác

Các ví dụ trong tài liệu, bên cạnh việc minh họa cách sử dụng hàm hoặc phương thức, phải là mã Python hợp lệ, trả về đầu ra đã cho theo cách xác định và người dùng có thể sao chép và chạy

Các ví dụ được trình bày dưới dạng phiên trong thiết bị đầu cuối Python.

class Series:
    def plot[self, kind, color='blue', **kwargs]:
        """
        Generate a plot.

        Render the data in the Series as a matplotlib plot of the
        specified kind.

        Parameters
        ----------
        kind : str
            Kind of matplotlib plot.
        color : str, default 'blue'
            Color name or rgb code.
        **kwargs
            These parameters will be passed to the matplotlib plotting
            function.
        """
        pass

class Series:
    def plot[self, kind, color='blue', **kwargs]:
        """
        Generate a plot.

        Render the data in the Series as a matplotlib plot of the
        specified kind.

        Parameters
        ----------
        kind : str
            Kind of matplotlib plot.
        color : str, default 'blue'
            Color name or rgb code.
        **kwargs
            These parameters will be passed to the matplotlib plotting
            function.
        """
        pass

Cách trình bày ví dụ như sau

1. Nhập các thư viện bắt buộc [ngoại trừ

   def unstack[]:
       """
       Pivot a row index to columns.
   
       When using a MultiIndex, a level can be pivoted so each value in
       the index becomes a column. This is especially useful when a subindex
       is repeated for the main index, and data is easier to visualize as a
       pivot table.
   
       The index level will be automatically removed from the index when added
       as columns.
       """
       pass
   

   6 và

   class Series:
       def plot[self, kind, color='blue', **kwargs]:
           """
           Generate a plot.
   
           Render the data in the Series as a matplotlib plot of the
           specified kind.
   
           Parameters
           ----------
           kind : str
               Kind of matplotlib plot.
           color : str, default 'blue'
               Color name or rgb code.
           **kwargs
               These parameters will be passed to the matplotlib plotting
               function.
           """
           pass
   

   3]

2. Tạo dữ liệu cần thiết cho ví dụ

3. Hiển thị một ví dụ rất cơ bản đưa ra ý tưởng về trường hợp sử dụng phổ biến nhất

4. Thêm các ví dụ có giải thích minh họa cách sử dụng các tham số cho chức năng mở rộng

Một ví dụ đơn giản có thể là

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

Các ví dụ nên ngắn gọn nhất có thể. Trong trường hợp độ phức tạp của hàm yêu cầu các ví dụ dài, nên sử dụng các khối có tiêu đề in đậm. Sử dụng dấu sao kép

class Series:
    def plot[self, kind, color='blue', **kwargs]:
        """
        Generate a plot.

        Render the data in the Series as a matplotlib plot of the
        specified kind.

        Parameters
        ----------
        kind : str
            Kind of matplotlib plot.
        color : str, default 'blue'
            Color name or rgb code.
        **kwargs
            These parameters will be passed to the matplotlib plotting
            function.
        """
        pass

class Series:
    def plot[self, kind, color='blue', **kwargs]:
        """
        Generate a plot.

        Render the data in the Series as a matplotlib plot of the
        specified kind.

        Parameters
        ----------
        kind : str
            Kind of matplotlib plot.
        color : str, default 'blue'
            Color name or rgb code.
        **kwargs
            These parameters will be passed to the matplotlib plotting
            function.
        """
        pass

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def astype[dtype]:
    """
    Cast Series type.

    This section will provide further details.
    """
    pass

class Series:
    def plot[self, kind, color='blue', **kwargs]:
        """
        Generate a plot.

        Render the data in the Series as a matplotlib plot of the
        specified kind.

        Parameters
        ----------
        kind : str
            Kind of matplotlib plot.
        color : str, default 'blue'
            Color name or rgb code.
        **kwargs
            These parameters will be passed to the matplotlib plotting
            function.
        """
        pass

def astype[dtype]:
    """
    Cast Series type

    Missing dot at the end.
    """
    pass

class Series:
    def plot[self, kind, color='blue', **kwargs]:
        """
        Generate a plot.

        Render the data in the Series as a matplotlib plot of the
        specified kind.

        Parameters
        ----------
        kind : str
            Kind of matplotlib plot.
        color : str, default 'blue'
            Color name or rgb code.
        **kwargs
            These parameters will be passed to the matplotlib plotting
            function.
        """
        pass

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def astype[dtype]:
    """
    Cast Series type.

    This section will provide further details.
    """
    pass

def astype[dtype]:
    """
    Cast Series type

    Missing dot at the end.
    """
    pass

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def add_values[arr]:
    """
    Add the values in ``arr``.

    This is equivalent to Python ``sum`` of :meth:`pandas.Series.sum`.

    Some sections are omitted here for simplicity.
    """
    return sum[arr]

def func[]:

    """Some function.

    With several mistakes in the docstring.

    It has a blank like after the signature ``def func[]:``.

    The text 'Some function' should go in the line after the
    opening quotes of the docstring, not in the same line.

    There is a blank line between the docstring and the first line
    of code ``foo = 1``.

    The closing quotes should be in the next line, not in this one."""

    foo = 1
    bar = 2
    return foo + bar