{"action":"created","issue":{"url":"https://api.github.com/repos/dotnet/docfx/issues/2328","repository_url":"https://api.github.com/repos/dotnet/docfx","labels_url":"https://api.github.com/repos/dotnet/docfx/issues/2328/labels{/name}","comments_url":"https://api.github.com/repos/dotnet/docfx/issues/2328/comments","events_url":"https://api.github.com/repos/dotnet/docfx/issues/2328/events","html_url":"https://github.com/dotnet/docfx/issues/2328","id":283887800,"node_id":"MDU6SXNzdWUyODM4ODc4MDA=","number":2328,"title":"DocFx doesn't take <inlude> tag into account.","user":{"login":"r-christopher","id":19379567,"node_id":"MDQ6VXNlcjE5Mzc5NTY3","avatar_url":"https://avatars1.githubusercontent.com/u/19379567?v=4","gravatar_id":"","url":"https://api.github.com/users/r-christopher","html_url":"https://github.com/r-christopher","followers_url":"https://api.github.com/users/r-christopher/followers","following_url":"https://api.github.com/users/r-christopher/following{/other_user}","gists_url":"https://api.github.com/users/r-christopher/gists{/gist_id}","starred_url":"https://api.github.com/users/r-christopher/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/r-christopher/subscriptions","organizations_url":"https://api.github.com/users/r-christopher/orgs","repos_url":"https://api.github.com/users/r-christopher/repos","events_url":"https://api.github.com/users/r-christopher/events{/privacy}","received_events_url":"https://api.github.com/users/r-christopher/received_events","type":"User","site_admin":false},"labels":[{"id":591346667,"node_id":"MDU6TGFiZWw1OTEzNDY2Njc=","url":"https://api.github.com/repos/dotnet/docfx/labels/feature-request","name":"feature-request","color":"f9d0c4","default":false},{"id":776266919,"node_id":"MDU6TGFiZWw3NzYyNjY5MTk=","url":"https://api.github.com/repos/dotnet/docfx/labels/help-wanted","name":"help-wanted","color":"0B66D5","default":false}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2017-12-21T13:49:57Z","updated_at":"2019-05-11T14:53:09Z","closed_at":null,"author_association":"NONE","body":"**DocFX Version Used**:  2.28.3\r\n\r\n**Template used**: default\r\n\r\n**Steps to Reproduce**:\r\n\r\n1. Create a \"documentation.xml\" file at the root of project.\r\n\r\n```\r\n<?xml version=\"1.0\" encoding=\"utf-8\" ?>\r\n<Documentation>\r\n  <MyClass>\r\n    <MyMethod>\r\n      <remarks>\r\n        One remark\r\n      </remarks>\r\n    </MyMethod>\r\n  </MyClass>\r\n</Documentation>\r\n```\r\n\r\n2. Add the tag <include> on the top of a method.\r\n\r\n```\r\n/// <summary>\r\n/// This method should do something...\r\n/// </summary>\r\n/// <include file='../Documentation.xml' path='Documentation/MyClass/MyMethod/*'/>\r\npublic void OneMethod()\r\n{\r\n\r\n}\r\n```\r\n\r\n3. Compile documentation\r\n\r\n**Expected Behavior**:\r\n\r\nThe Remarks topic should be displayed on the documentation page. \r\n\r\n**Actual Behavior**:\r\n\r\nThe Remarks topic doesn't appear. \r\n\r\n\r\nIs the <inlude> tag supported by DocFx ? "},"comment":{"url":"https://api.github.com/repos/dotnet/docfx/issues/comments/491517530","html_url":"https://github.com/dotnet/docfx/issues/2328#issuecomment-491517530","issue_url":"https://api.github.com/repos/dotnet/docfx/issues/2328","id":491517530,"node_id":"MDEyOklzc3VlQ29tbWVudDQ5MTUxNzUzMA==","user":{"login":"smaillet","id":25911635,"node_id":"MDQ6VXNlcjI1OTExNjM1","avatar_url":"https://avatars2.githubusercontent.com/u/25911635?v=4","gravatar_id":"","url":"https://api.github.com/users/smaillet","html_url":"https://github.com/smaillet","followers_url":"https://api.github.com/users/smaillet/followers","following_url":"https://api.github.com/users/smaillet/following{/other_user}","gists_url":"https://api.github.com/users/smaillet/gists{/gist_id}","starred_url":"https://api.github.com/users/smaillet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/smaillet/subscriptions","organizations_url":"https://api.github.com/users/smaillet/orgs","repos_url":"https://api.github.com/users/smaillet/repos","events_url":"https://api.github.com/users/smaillet/events{/privacy}","received_events_url":"https://api.github.com/users/smaillet/received_events","type":"User","site_admin":false},"created_at":"2019-05-11T14:53:09Z","updated_at":"2019-05-11T14:53:09Z","author_association":"NONE","body":"Will this ever be supported? It's a blocker for a project I'm working on. I'm unclear on how this isn't supported since the C# compiler is what processes the include to produce the final doc comments .xml for an assembly at compile time - so why does docfx get in the middle of things to actively block this?"}}
{"actor":{"display_login":"smaillet"}}