implemented review suggestions (#427)

* implemented review suggestions

* header change

Author: ayush-kumar-423

examples/00-basic/12-get_material_properties.py

@@ -4,11 +4,8 @@
 Get material properties from the result file
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 Material properties are assigned to each element in APDL and by default they
-are written out in the APDL result file. We can extract material properties
-of each element using PyDPF by getting the properties from the `meshed_region`.
-
-The material properties are then passed onto the operator
-`mapdl_material_properties()`
+are written out in the APDL result file. This example shows how we can extract
+material properties of each element using PyDPF.
 
 Import necessary modules:
 """
@@ -21,29 +18,32 @@
 model = dpf.Model(examples.simple_bar)
 
 ###############################################################################
-# Get the `meshed_region` from model's metadata.
+# Get the :class:`meshed_region <ansys.dpf.core.meshed_region.MeshedRegion>`
+# from model's metadata.
 mesh = model.metadata.meshed_region
 print(mesh)
 
 ###############################################################################
-# See available properties in the `meshed_region`
+# See available properties in the :class:`meshed_region
+# <ansys.dpf.core.meshed_region.MeshedRegion>`
 print(mesh.available_property_fields)
 
 ###############################################################################
 # Get all the material properties
 mats = mesh.property_field("mat")
 
 ###############################################################################
-# Use the DPF operator `mapdl_material_properties` to extract data for the
-# materials - `mats`. For the input `properties_name`, you need the correct
-# material property string. To see what all strings are supported, you can
-# print the operator help.
+# Use the DPF operator :class:`mapdl_material_properties
+# <ansys.dpf.core.operators.result.mapdl_material_properties.mapdl_material_properties>`
+# to extract data for the # materials - `mats`. For the input
+# `properties_name`, you need the correct material property string. To see
+# which strings are supported, you can print the operator help.
 mat_prop = model.operator("mapdl_material_properties")
 mat_prop.inputs.materials.connect(mats)
 
 ###############################################################################
-# For the input `properties_name`, you need the correct
-# material property string. To see what all strings are supported, you can
+# For the input pin `properties_name`, you need the correct
+# material property string. To see which strings are supported, you can
 # print the operator help.
 print(mat_prop)